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They fax, scan, copy and deliver laser-equality printing—at an impressively low cost 
per page. Individual ink cartridges soVe money too, because yoti only replace what runs out. 
HR PC Mcsgazine’s Readers’ Choice for service and reltobility for 15 years running. 


BEST 

.Hi? Offjaajet Pro L 7780 AiO. 
Plus wifeioss netv^rking. 

$499. 


BETTER 

HPOfficajetPtoL 7680 A;O 
Plus iwo-sided pr<rting 

$399. 


GOOD 

HPOf{ieejefProi75SOAfO. 
Up to, 35 pages a mtwtQ. 

$299. 


UP TO 25% LOWER COST PER PAGE THAN LASER PRINTERS: 
HP OFFICEJET PRO ALL-IN-ONES STARTING AT $299. 


To learn more, visifr h p, com/go/does ita II Call VSOO-888-3119 Or visjf your loco! reseller or retailer. 


*CosJ pef poge (CPP) los^r supplied connparisoiis ba&ed On pubF^shod r^a^u^Qdui'£!f speclflcatforts of ihe highest copodfy oarifidgta ovoibble for cobf bsor all-in-ontrs under 
$1^000 and moro bser alhm-ones under $5Q0, os reported by Current Apotysbr Inc. os of July 2006. Office|sr Pro L7S(X)/L7600/L7700 AiO CFP bosed on HP 88 Large Ink 
Cortridges (not includedj sold separately) estinnoted street price and publF.sfii^ yield: Results may:ydry. Estimated U.S. retail price, Actual price may vary. Stmubted Images. 
©2007 Hewbtt-Packard Dovelopment Company, L,P. 






HARD DRIVE HOSED? 


DISPLAY DAMAGED? 



REPLACEMENT PARTS** UPGRADES •REPAIRStEOR YOUR MAC' 

:: ,, • , . • . ' :.^r ' .. ■ ■ ■■■■■' 


• FREE ONLINE DO-IT-YOURSELF GUIDES 

• Send-in Repair Service 
• BATTERY REPLACEMENTS FROM $ 94.95 
• POWER ADAPTERS FROM $ 24.95 



VISIT US ON THE WEB» 
OR CALL 866.726.3342 


PowerbookMedk 


v,PowerbookMtd*c.com 
Sparkman Dr. Ste. te20 
itsvMle.AL 35816 
'Fax: 866,726.3342 



.com 


Your Mac^K^ Our Patient 







MacMall is the *1 Apple Direct Reseller & 


Tod tools for creative 


NEW Apple systems! Now with Mac OS X Leopard! Even boots Windows! 



MacBook” Pro 

Ships with NEW iLife' '08 
and Mac OS X Leopard! 

■ Ijltd Cote 2 Ouo speeds up fo 2MWi 

■ MViOIA video gFCphks ■ MsKOiy^ree 15" LCD 

i Builtin: iS^ghr', oritf Glgobii filiemeT 


MacBook Pro starting or 


(mall-ln rebate) 


finance for-60/mo 


Bun VV^ndbws 
on your Mac' 



NEW iPod touch! 

Ari7* tM [rimsmitict ,' 

(r.Q! OviiHI tWii Shippit-'i: 

m r-iri VfMrlr '■ -ider 

■ ’,Vri ’f.i.. 

■ l^flc ■: 

8 GB Ofily ^294!tf7297636 



: ■ ' • / : - d . i . r Ci-*Pi 

Fc^.v :ni^ 'utippingt 


• ilp k ^ licniPi tji I ■ ■ viiicoi end mm's 

4GB Silver only 144 ! #7297625 


#7297626 HGBSiirvi '194 

i72V-m ouBWiie '194 

*7297520 SGBGrtv. '194 

729/627 SGB BI.Kh 194 



NEW iPod classic! 

FREE FM Transmitter, Cose, 
titiinimp and Shipping!' 

• NEW Ateld 

■ lloilii IJ^V40.0" 50111^5 ■; 16060 nMxyi 

• 7 ■' tdw iiD 

80 GB Silvef only ~244!»72976i1 



NEW iPod shuffle! 

Fhi L: -i Transmitter 
und ; /7i,uJWno/ 

■ 1 our rolei^ 

■ Boldi up to hi^iWolitv so^^^ 

IGB Blue V81 #7297622 

»729761» ICifl Silvef '78 ' 

*7297622 IGBGi-cn '78“' 

#7297624 IGBPuiple '78'^ 


VMwore Fusion 
for Mqc 
#728641 ) 


After S2£} mfr mail-bi rebate. Price 
befora is S64.99. See below' 


PorolEels Desktop 3.0 
for Mac 

#7257316 HI 


57999 / 


Apple Real Cul Sludb 1 
#7236215 

I Ai l 


Microsoft Office 2008 Coming Soon! 

Buy Office 2004 loday and upgrodo to Office 20DB for 
only ** SiHI get o FREE polo shirt with porthose 
of Office 20D4I While supplies losi I Coll for detaiis. 


CDtfIce 2004 only 


'729’*/. 
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MacMall > 
Exclusive Deals! 

Get Up to *200 cash back! 


FREE HPAII-in-One Printer! 
FREE Shipping!' 

See below for details. 

\ MacMall is your source for y 
. LCD and Plasma TVs! 




FREE Parallels Desktop 3.0! 


fk Authorized Reseller 


iMad 

Ships with NEW iiife '08 
and Mac OS X Leopard! 

m Intel Core 2 Dtio pnxessm q\ yp fa 2.4&K? 

Of Intel Core 2 pflKossor of 2.9GHz 

■ !Jpto5f}06BSonGfATAboiddnve 

■ Aknffmim coiing and yjtTEhlhin keyfcio^ 

■ iSight" S02.1 In wireleis ond GSgabit Memet 


the Mac pro's choice! 

pros! 


Ships with NEW iLife'08 
and Mac OS X Leopard! 

■ More systim wrlti two OuMRort pfocessara at 3GH2 or Koeo 
system wfth two OyaKore Intel Xeon processors ot up to 36Hi 

■ NI/IDIA GeForce 730061 gmphics ■ Gigobif Eiiiomet 

Mac Pro atoning at 


Choose your iMac: 

20" Apple iWlac—2GHz Intel Core 2 Duo 
#7260171 ofY]yHW^'50 = *1144!' 


iMac startir^g at 


^219A ”^700 (■mo//-(V) rebofej 


20 " Apple IMac— 2 .AGHZ Intel Core 2 Due 
#7288181 only^«W-* 7 S = ‘ 1419 l’ 


(mail-in rebate) 


Q094t 

Finance for 


24“ Apple iftilac— 2.4GHz Intel Core 2 Duo 
47288182 only -'100 = '1894!' 

24“ Apple sMac— 2.BGHz Intel Core 2 Ei«treme 
47288393 only *2294-^100 =: *21941' 


m44r 

fmaace /or"i8/mo 



NEW Mac OS® X Leopard"! ^ 

Over 300 innovations! Desktop, Quick Look. 
Time Machine, Spaces, Photo Booth and more! 


• Twimi 


i'-iACTECH 


Adobe Creative Suite 3 
Waster Collection 

C^hraUordsUt 
upg^yxdM 

#7228222 



only 


’2472®/ 


Apple Cinemo Displays 

#459336 20" Cinema DispEay^ 
71^*594 

#459837 23^ Cinema HO Display 
itas^ rt£3iv*B94 
#459336 30" Qnema HD Display 
«3ttf*1794 



Applet AirPart^ Extreme 
Bnse Slatian 

#7283377 



Staxio Tofrst 6 raaniuin .* 

#71717K.i 



^i5g4S/ » 

Pnc6 afterS20 competitive upgade 
mff. malMn rebate See below.' 
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f tbniary Ls one of my favorite months for a few reasons. Living in the Nortlt Eiist of North 
Amerk'M, Fehriuiry brings lK>th fiarsli arid and lieautiful spring-like days. It reminds me that 
change is coastant, and sometimes, you find the pleasant ensconctxl in liie unpleasant. We've 
been doing a lot of work - since the early Ix^ta days - with the new Microsoft Office Suite, 2008 
for Mac. If this change was mtire than you cnvisit>ned, and you are a scripting person, now is a great 
lime to revisit ilie MaeTecli Office Transition Guide, piiblislted in the April 2007 issue. Ifs also available 
on-line (viewable, and as a purcliasable PDF) athtlp://www.mactech.com/vba-transifion*guide. 
MacTech also creatcxl c|trite a stir willi our virtualization benchmarks, when released in Decemlx^r 2007. 
WeVe had great feedback and amversatiuns with people interested in how they can ext rude those 
ic^suIls into situations applicable to them, anti more. Well be following up on all of that in the future. 
One thing to rememlxT with these Ix^nchmarks^ change is always at work, here, itxx tioth Parallels 
and VMWare coniinue U) grow their prcKluds* and Microscjft cujttinues to releiise patches for XI" and 
Vlsia, changing liow they interact with your machine. Change is everywhere! 

We’re thrilled to have Jose Cruz lejid us ih rough an intro to Git. Git is a version control system 
that has been gaining aUenlit>n and pof>ularily thunks to its unique approach and features, if you’ve 
heard alxiui Gil and were curious, "Working with GiC is the place to start! 

Ben Waldie - AppleScript nxiven, and tbnner Madech t tilurnnisl - has ct)nirilnitd.t an article sure 
to help anyone using AppleScript in an Adolxr CS3 envinjumeni. Tor those of you who have heard 
Ikn preseni at Macw'orld, or read one of his hooks, you already know what a great teacher he is. With 
there always lx*iiig something new to learn, hAkm Ben as he tleals oui more great AfipleScript 
knowledge. 

More changt^l A[)ple releases a new OS (Leopard) and all of the certification courses and tests 
now need an tjverliaul (change). Doug Hanley l>rings us pan 3 of updates to Apple certifications, Hiis 
time, he guides you through Apple's Hardware Repair Certification, whicli qualifies a tediiiician to 
pL^rform waminty repairs on Apple prcxtncLs wlrile working at Apple-authorized service facilities. If 
you're a hardware geek, this is a cxceileiU direction to take, scoring you the cert and the pcxssibiliiy of 
.stane extra coin. 

'I'his monili's MacEnierprise column brings us soiiie great iiew‘ funtlionality in Workgroup 
Manager and preference manifests. Managing your machines once they're in the end-user's hands 
lakes a number of different paths, and tliis is just one more method lor your sys admin KmjIIxjx. 

*rhe other usual suspects are preseni this month, uxr. Dave Dribin's Road to (k>de expaiuls the 
leatJiing of Object Oriented Programming aix! Obfective-C, The Mac in the Shell disiiisses iUv 
differences thal Let>pard bring.s to your shell scripUng environment thanks to Unix 03 certification 
(change!). Of cour.se» we round out the issue with someone I King (eat u res in the MacTech Spotlight. 

This mrmrlVs Spotlight fcx’uses on Marcus S. Zarra, Owner of Zarra Saidios. I first heard (if Zarra 
Studios through their product “iWeb Buddy.” What maily intrigued me, however, was “seSales,'' a Point 
of Sale System for OS X - a category that .seem.s heitti- served all the lime! Marcus has interesting 
perspectives and tleep knowledge of development on the Mac. Were hoping to see more from him 
in the future. 

For a “short month,” we have a lot to pack into it! Perhaps it's the fitci that we're still ahsoriiing 
e\'erything that came out of Macworld. Perliaps li's iKX'ausc Lc\>f>ard is still so new'. Of course, it could 
be that i’hange i.s constant, and forever keeps us oa our toes! Tliis issue went to the printer JtLsi txfon* 
Macworld, so we'll see more comprehensive news from there next month, tlniil then, enjoy! 

Edward Marr/iik, 

Exeaitive Editor 
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by Edward Marczak 


What Has Really 
Changed in 
Leopard? 

Some differences for us 
Unixy scripting people 

___ J 


While OS X has, from the beginning, had a BSD layer on 
top of its Mach kernel, an<i typically followed BSD 
semantics, leopard changes all of this. As of OS X v 10.5, OS 
X follows ATOT semantics for most command-line utilities. 

Where Does it Hurt? 

OK, Apple changed this over, so wliat? Well, like any 
target upgrade, you need to ensure that long-time scripts stiO 
work, t pcTstmally got bitten by the change as the sort 
utility no longer uses the GNL) semantics that 1 had gotten 
used to. Lefs take a look there first, 

I liad a script that used sort in the most simple way^ 
to sort data on a single column. To do this 1 used the now- 
deprecated plus-notation: 


Introduction 


gGnerate^data | sort +4 > final_file.txt 


Tlie dichotomy strikes me as a bit amazing: on one 
hand, I don r find too many erxhusers that can really 
C|uantify wliat'.s l>eUer about Leofiard as compared to Tiger. 
I've upgraded some people that just had to have the latest 
and greatest and honestly, they haven’t noticed much 
difference. Tlie Hip side of this is the tech perspetlive: take 
ju,st about everytliing you undeistood in Tiger and throw it 
out the window. I’he underlying technology in Leopard Is 
radically differeni in many w^ays from its predecessor. So. 
specifically, what is different for us shell-dwellers? 

“Real” Unix 

Leopard \s the first version of OS X that is LTnix 03 
certifiecL Wliai does tliai mean? To understand ihis rec|uires 
a sJiort trip back in time (cue Time Machine space 
backdrop...), though not too far. 

Unix and Unix-like operating systems fall into several 
categories, AT^tT/Bell Dibs' Unix (UNICS, then UNIX System 
VI) is the oldest variant anti often the reference 
implementation. ’"BSD Unix" was originally distributed at 
Berkeley University (Berkeley Software Dislnbulitm) and did 
things differently than \T^T Unix. Over the years. BSD and 
ATtVr Unix have diverged significantly, in the early I990’s, 
we began to see tlte rise of GNU/lJnux and yet an of her 
method of doing things. 

Often, one would find tools from another Unix platform 
that were missing from (or just better than) the tools on your 
cuiTent platfcsrm. Over time, these tools would get ported, 
but not necessarily in a way consistent with the target 
platform. Standards have emerged, such as POSIX, that 
generally smooth over these cross-platform differences, but 
not everyone follows the standards. 


Along comes Leopard which acted like I was insane. 
nolation? What are you talking alx)Ut? That doesn't exist.” 
A quick trip to the man page revealed that this is true: 

sort lUPTlON],,, iFiLE]... 

,..wath no plus signs in the man page anywhere. However, 
a quick irit) back lo Tiger ^siiowed that I wasn’t crazy: 

SYNOPSIS 

sort l-cmusj Ut separatorJ |-o output■file] [ 

T tcmpdlr] [ bdfiMtirJ 

[+P0S1 t^P032j] l-k POS1UPOS2]] [file.,.] 
sort [-hclp.-versionI 

Ah ha! Of course, running under Leopard, I still needed to 
update my script. Nam rally, there had to be a hurdle, no 
matter how small: the plus notation counts fields from zero 
like a computer, and the '‘-k" switch counts from i like a 
human. So, my incantation now had to read: 

gerierate^dats | sort -k 5 > finul_file.txt 
In any case, the issue was ntjw fixed. 

Portability 

Wliile tlie case I just gave was easily solved, be awiire 
that all of these differences can cause issues when writing 
sedpt.s that will deployed cross-platform - whether the 
platforms in t|uestion are intra-OS X or iK'yond those bounds 
to Solaris, Linux, etc. 

A command as .seemingly .simple as chown may trip you 
up if your script is to run on differeni OSes. Typically, if you 
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use chown on a synilink, rhe symiink itself remains 
iinmcKlified, while ihe target of the .symiink is altered. This 
can f)e changed witli the -P flag. In KYikT semantics, issuing 
the following commands alter the symiink: 

In *5 file.txt teet.txt 
ctiDwn IP iis^r test.txt 

In BSD, the owner of the symiink is nol altered. Yes, this 
includes ]tf4 and earlier. 

Another one that has caught many is echo. To prompt 
For input, it has been nice to fall hack on the “-n" iiSDism 
that removes suppresses echo from printing a newline 
character. However, under leopard, this seemingly broke. 
Fnistratingly, visiting the man page for echo showed that 
n” was still valid and should do what you'd expect. What 
was going on? 

Technically, echo is a shell built-in. Prior to 1(15, the 
l>uili-in and tlie version in /l>in happened to have the same 
behavior 10,5 brings the built-in up to SlJSv3 conformance 
using AT^T semantics, meaning, no “-n" switch. Of course, 
the shell executes built-in befetre looking along $PAT11. Now, 
anyone who simply specified ‘"echo” (just about everyone, 
myself included), and needs rhe “-n” switch got a surprise. 


There's a few ways to handle this. Tile easiest is to call the 
external echo in /bin, as it still supports "-n* This may 
actually he your liesi choice in many ca.ses as there are many 
tutorials and documents that assume the availability of the 
n'* switch. 

Another option is to AT&T-ify it. This requires yt)u lo 
drop the “-n" Hag and finish off the string with a "V 
cl la racier: 

echo “Enter ntmber of eeconde: Vc" 

rhis is perfect, if you Ye going allTropard. 

The best choice may he to dro[) the use of echo 
altogether. printf is a more robust and universal 
conunand. On all systems that I can think of, printf will 
not print a newline at all, and requires a '\iT cluiracter to do 
so. For cToss-platform scripting, printf is the way to go- 

In fact, printf is even more flexible than echo, 
mimicking some of Cs fonnaiilng fiinciionality. Of course, 
note that printf comes in hoih a built-in and external 
version. 

Finally, keep in mind that sometimes, it's simply return 
codes that differ between phillorms. So, while some 
ctmimand may do the same thing, in exactly the same way: 

fno_paurK:fir -k -d 7 -y 

stKcess and failure (or error) may be defined differenlly in 
$?. Some programs will silently ignore errors, returning a 
Eero. Kemember lo test ihe.se scenarios between destination 
[ilmforms. 

A final example i>f this: we've been accustomed to BSD- 
ba.sed cp’ to copy file.s. Under bSl>, cp will march through, 
despite ern>rs and copy as much as possible. ATlkT 
semantics have cp abort after the first error Subtle, and 
something that will only crop uj> under a failure ctmdition. 

Conclusion 

Of course, iliis tloesn'i begiti lu cover what has really 
changed in Leopard, as there is so much that has, on so 
many different levels, Those of us working in the shell, 
I hough, do need to he aware of w hat the new SUS 
certification means to us, and how the AT&T semantics 
affects our scripts. Remember: test, test, test! 

\\\ I 
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The Road To Certification 

(Part 3) 

Increase your knowledge 
and build credibility on the way 


by Doug Hanley 




Introduction 

In the firsi iwo articles in litis series, we ltx>kecl at Apple’s 
rr cenificiilioas. We examined reasons tor and Ix-nefiLs of 
getting certified, as well as the testing experience and the 
changes Apple made to its IT ceriificalions witli the R'lease of 
Mac OS X leopard. Now we are g<nng to take a punillel path 
and examine Apple's hardware repair certificalitm |OTt 
‘'Macintosh Technician” certificationi This ceitificalion tjtialil'ies 
a technician to [)ciTorm warranty repairs on Apple products 
while working at Apple-authorized service facilities. 

Apple Certified Macintosh 
Technician 

In the pasi there were two disiinct ccrlifielions for ilcjing 
hardware repain ACDT, Ai>ple Certiftcalion Desktop 
Technician, and ACIH", Apple Certified Portable Ttrhnician. To 
achieve those certifiraticms, one had to pass the Mac OS X 
Service and Support Kxam as well tile specific desklt)p or 
jxjrlahlc liardware exam for die certificatian. l*assing the Mac 
OS X Suppon P„ssentials Hxain would also qualify for the 
operating sysicm |>oru>n of the ceriification. As of December 
2007, Ai>ple replaced the ACDT and ACFf certifications witli 
the unified Apple Certified Macintosii Tectmici^in, ACMT 
Cx^nific-ation. The ACDT and ACFT exams are no longer 
available. 

Tile ACMT' certifiratinn still recjuires llie Mac OS X Service 
and Support Hxam but it only axjuires one hardware exam: the 
Apple Macinttish Hardware Exam. This is an expiring 
certification and needs to lie renewed every yc^ar. One 
important change to note is dial the Sup[Kn1 Essentials Exam 
no longer fulfills the operating system requirement of the 
certification. Tliese exams are available at Promeirit* Tesiiog 
centers. As we disaissed in our first article, you are tvtjuired to 
have an Apple Tech ID l^efore you can register tor an exam. 
One of the key differences in the service certification is that you 
need to recenify every year. TTie recenificaiion exams are 
available online, 
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Categories Covered in Mac OS X Service 
and Support Exam 

Wliilc similar in scope and content to other Apple 
certification exiinis, the Mac OS X Service* and Supfiort Exam 
fixirses more on irouhleshtx>iing Mac OS X. Tliere are SO 
C|Liestif3ns covering eleven topics. You neecl to get at least 32 of 
the SO questions correct to achieve a passing score tif 64%. 

I lere is an overview of the tr>pics covered: 

L IntKxIuction C5 items) 

Identify assistive feiaires of Mac OS X 
Identify iChat features in Mac OS X 
klemify iChat ra|uirements in Mac US X 
Identify Safitri feiitures in Mac OS X 
Identity DashlToard features in Mac OS X 
2, Installation (2 items) 

Detenniiie that a specific computer meets the minimum 
requirements to run Mac OS X v 
3* Users (3 items) 

Describe security issues involved with user acc^ounts and 
passw'orcLs in Mac OS X 

4. File Systems (3 items) 

Describe search patlis, hidden folders, and system-related 
folders 

Formal a hard drive on Mac OS X 
Manage llie Mac OS X fde system 

5. Permissions (4 items) 

IX'sc^rilx^ the Ix'havior of the different (x^miission settings 
on files and lulders 
TrcmlMeshcxX permissions Issues 

6. Application Environments (5 items) 

Use Activity Mtinitor It) monitor appliotions' use of 
inemory and proc’essor 
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I>escribe accessibility features in Mac OS X 
Install, run, and iroubleshofjt native Mac OS X applications 
7* Network Configuration Sl Troubleshooting (3 items) 
Descril')e basic networking concepts and terms 
Use Network Diagnostics, Network Utility^ and Network 
Preferences to troubleshoot networking issues 
Use network preferences to detenu ine the state of a 
network interface. 

8. Peripherals G items) 

kleniify what devices are connedcd to a Macintosh 
computer 

List the types of drivers used in Mac OS X to 

communicate with peripherals 

Perform basic lroiiblesh<K>ling of jX-Tit^heral Lssues 

9. Printing (2 items) 

Use Printer Setup Utility to trouhlesh(K>i printing issues, 

including printer sharing 

Describe the print proces^s in Mac OS X 

10. Startup Sequence (7 items) 

Troulileshoot startup issttes, including slarlup items and 
login items 

Identify the different stages of the startup sequence and 
ilieir eorres[X)nding visual or auditory cues 
IL Troubleshooting (13 items) 

Resolve a Kernel Panic in Mac OS X 

ll.se ttx)l.s included with Mac OS X to resolve customer 

issues more efficiently 


Use Network Diagnastics to troubleshtxjt a networking 
issue 

Determine if a task is jK)ssible in Safe Mtxle 
Recogni/e wlial action a Safe 1 Relaunch performs in Mac 
OSX 

Resolve an applit:ation/framework version mismatch issue 
in Mac OS X 

Use Disk Utility to verify the directory of a volume in 
Mac OS X 

Reset a user fr4Lssword in Mac OS X 

State what starting up in Safe Mexie d<x:s in Mac OS X 

Categories Covered In The Apple 
Macintosh Hardware Exam 

questions in 23 sc'ciions. You need to answer 6S (juesiions 
correctly out of tlic 90 for a 72% passing gntde. In addition, 
them are two sections that ytai musi pa.ss witli a specific 
IXficencage. For the F.SI), Electro Static Discharge, you must 
]>ass at 80%. or 4 out oi 5 items. The ^Pechnician Safety section 
re{|uiremcnt is 8 out of 11, or 73% percent correcL 

Here is an overview of the topics coveaxi in this exam: 

1. Basic Computer Theory and Terms - 2 items 

Identify nomial and abnormal computer operation to 
include: 

Startup. Sleep, Shut Down and Kernel Panic 
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2. Underlying Technologies - 3 items 

DcfK.Tibe the function of the foljowing Icclinologies: 

ALS (Atnl)ient Light Sensor), ATA/SATA, Bluetooth, 
ColorSync, Compression, CUPSD VllvFl Etlierner, 
HxpressCard/34, FireWire, Infrared, MIDI, Modem, Optical 
Audio, Optical drives, PMU, QuickTime, Rosetta, Serial 
Anached SCSI (SAS), SMC, SMU, Sound in/out (analog, 
digital, ofHiral), Sudden Motion Sensc.)r, USB/USB 2.0, 
Video in/out, and Universal Binaries 
Identify common jxjrts found on Apple computers gK^en 
pictures and/or logos. 

3* References - 6 items 

Using the Apple Support site, locate the following 
resourrres for a sjxjciried Apple prtKluct: Trouhleshotuing 
tnfunmtion Configuraiion (Ixised on serial number) 
Warranty Status of a prcxJuct User Manual Product 
speci heat ions 

Using Service Source, Knowledge Base, and C^SX (if 
available), locate the following information for a specified 
Apple product: Service News (if available) Service 
Manuals Compatibility information Take-apart procedures 
Symptom Charts Screw Matrices P^irLs and configurations 
(If GSX is available) Sc'rvice part numlxrs (If GSX is 
available) Disc images/diagnostic software (if available) 
Given a specific service issue, identify which Apple 
reference will prodijc:e the most intbrmative re.sulls. 


4, Diagnostics - 3 items 

Interpret reporLs from Apple Hardware Test. 

Describe when to use AHT. 

Identify when Apple Service Diagnostic (ASD) is used. 

5, Hardware Tools - 5 items 

klenlify the conect hardware tools to service different 
Apple products. 

Identify specialiyicd tcKjls available from Apple. 

Given a s(>edfic Apple prfxkicl* klenlify all lianlware 
tools needed to perfbnn a partiailar module replacement. 

6, Troubleshcxiiing Theory - 22 items 

Slate the primary goals f>f trouble.shooimg. 

State the general steps of the Apple-recommended 
trf >ubles h oot i ng pr< k’c\ss. 

From a problem description, identify the most 
appropriate questions to ask a customer to help identify* 
the c'aiise of a problem. 

State three (jualities that make a repair aciion a t|uick fix. 
From a [problem description, identify liie most 
appropriate quick fix(es) to use. 

From a proldem de.scTiption, find the probable cause by 
applying knowledge of hardware com]X)nenLs and 
functions of Apple pRKlucLs. 

Describe the component isolaiitm troubleshooting 
meLlu)d. 

Describe what com|X>nenL.s are necessary for a minimum 
system. 

Given a t rou I >les h t joi i n g scena riu, cl eierm i n e wh e 11 ler a 
problem is hurdwaa* or strhware related by using 
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recommended Apple tools and strategies. 

Slate three reasons why you should test a full range of 
functionality when verifying a repair 
From a descrifition of a repair, identify the Apple 
rect>nimended diagnostic to verify the repair. 

Identify a>iTimon symploras that would l>e consitlered a 
"no power" condition. 

Identify symptoms that would be considered a “No 
Video'’ condition. 

7. ESD Precautions * 5 items (MUST PASS 4 OlfT OF 5 OR 80%) 

Fxplain how electnjstatic discharge (FSD) causes tUimage. 
List seven guidelines iisetl to reduce the risk of ESD 
damage. 

Descriix? several common niyilis alx>iJt HSD and wlty they 
are not true* 

Desciilx^ the impt>riance of each of tlie four essentials 
components of an ESD j^revention compliant workspace. 
Explain ESD preventive steps to Ix" taken when working 
on-site. 

8. Technician Safety - 11 items (MUST PASS 8 OUT OF 11 OR 
73%) 

Slate the risks of servicing CRTs. 

List the eight CRT safety rules. 

Descrilx* the CRT discharge pr(x:edure. 

Dcscrilx" the CRT disposal procedure. 

Descrilx" precautions for avoiding shock hazards on iMai^ 
systems. 


It has a beautiful touch screen, gorgeous 
form-factor and amazing capabilities... 
Our Job is to keep things that way, 

revo 

ni«T^,*TrC'. for ycur irhona 


Des^'ribe precautions for working with Krylox tliennal 
grease. 

Identify potentially hazardous materials used in Macintosh 

systems. 

9. Power Management - 5 items 

Explain the different pt)wer and operating modes in 
Apple systems, 

Descril>e five power saving technicfues for Apple systems. 
Describe how to calibrate a portable systenVs main 
battery to ensure o()liiiial battery performance. 

State which AC ]x>wer adapter works with a specified 
Ap]^ie poitable mtxleL 

10. liquid Crystal Displays - 3 items 

Descriix^ causes of pixel anomalies. 

DiagiKxse five common pixel defects. 

Describe similarities and differences Ix'tween CCFL and 
LED LCDs. 

11. Hardware Service Issues - 5 items 

Describe how to Rx'ate the A|)pleCyre name for a Mac, 
Identify the loaiUoiis, physical or otherwise, of a Mac’s 
serial niimixr. 

Identify any hardware or stjftware requirements to use or 
upgrade a Mac, using the Apple Support site. 

Identify special precautioas when working inside an 
Apple |X)rtal)le computer, 

12. Wireless Networkirtg Part 1-1 item 

Itientify feaiures on llie front and rear of the Airport 
Extreme (802.1 In). 

13. Wireless Networking Part 2-6 items 

Deseril)e hasie security leatures {)f wireless networking. 
^)iscl^^s apjxopriate probing que.slions when 
lroubk*shi>oiing AirPort issues. 

Determine whether io perfonn a Forced Reload (hard 
reset tfj factory default settings) or a Soft Rescl on all 
models tT AirPort Base Station. 

Descrilx ba,sic Bluett K)tli LrtxihleshtxXing issues, 

14. Mac mini - 2 items 

Identify any hardware or software requirements to use or 
upgrade a Mac mini. 

15. IMac -1 item 

DescTitsc the use of diagnostic l,EDs in iMac G5 and Intel- 
based iMac systems. 

16. Mac Pro - 2 items 

Descriix how to correctly install RAM in a Mac Pro, 
Itxplain tlie functitm of the diagnostic LliDs on a Mac 
PrtK 

17. Xserve - 2 items 

Descrilx equipment and precautions for Xserve hardware 
seivice. 

Describe feature and functions of ,Servcr Monitor. 

18. MacBook * 1 item 

Describe known issues for the MacBcK)k’s MagSafe 
connector 

19. MacBook Pro -1 item 

Identify troubleshooting issues for MacBook Prt> systems. 
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^ Seapine Software 

Satisfy Your Quality Obsession 



Fred Davidson 

VP of Quality 
Seapine Software 



Rich Clyde 

VP of Development 
Seapine Software 


Software quality and reliability are your lifelines to customer loyalty 
and profitability. Rigorous quality discipline and seamless collaboration 
between your development and QA teams will bring your customer-focused 
strategy to life. 

With offices worldwide and over 8,500 customers, Seapine Software 
is the leading provider of integrated quality-centric application lifecycle 
management (ALM) solutions. For over 12 years Seapine's easy-to-use, 
award-winning tools have helped companies achieve success by 
streamlining communications, improving traceability, and making 
development and QA teams more productive. 

Satisfy Your Quality Obsession. 

Visit Seapine Software at www.seapine.com/qualityreadyl 



Integrated ALM for a 
Quality-Ready Advantage 
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While other project managers take time to enter project 
tracking Information, you use Project X's unique Web 
App to let your resources take care of the data entries. 


One click instantly Incorporates timesheets, expense 
reports, and other task information, so you can spend time 
where it counts—managing your project! 


Successful project management has never been so easy. 


“We must txse time as a tool, not as a crutch.” 


—JohnEKennedy 


Macworld 


OF SHOW 

2 S D OF! 


Version 13 Now Available 
90 days of free telephone support 

Experience Project X, 
download your free fully functional 
30 day trial at wwwJProjeotX-Com 
or call 954.927,6031 


20. Power Mac G5 - 1 item 

Trt>u!>ieKhcK)t the Power Mitr G5 ihcniml control system. 

21. eMac -1 item 

Describe the [lurjKxse of the VGA outpul ptiri and its use 
in troubIestKx>cin^ an eMac system. 

22. iBook G4 -1 item 

i.ist the symjjtoms and solutions for tiie common |xjnal)le 
computer Issues using Apple’s r>niine resources (GSX. 
AppleCare Service Source), 

23. PowerBook G4 -1 item 

kicnlify wliicli PowerB<K:>k G4 computers sup[X>rt liot- 
swapping of the battery. 

Preparing for the ACMT Exams 

aiiere are a numix.T of ways to prepare for these exams. 
One is to simply review the Peachpit Book. Apple Training 
Scries: Desktop and Portable Systems, 3’^- Edition (ISBN: 
0321455010). The second is to purchase the self-paced 

AppleCare Tetlinidan Training fnim Apple at: 

http://www.apple.com/support/prQdgcts/techfram.hlml 

it includes one year of access to Service Source and online 
courses thai you can go through to prepare for the exams. 
A third way to prepare is through your employer, if they 
have access to Global Service Exebaiige (GSX). Via CSX, 
you have access to Service Source and those online ctnirses. 

Finally, tlie best way to prepare for iht‘ exams is to take 
I he hands-on courses offered ai Service Training and Testing 
Centers - Apple Authorized Training Centers that offer 
Ser\ace Training. A comprehensive five-day course, witit 
hands-(ui ex]>cnence taking apart desktop and laptop 
computers, is offered at .several locaitons across the Ll.S. - 

you can find their contact information at: 

http://docs jnfo. apple xom/ortkle. htmlartoum=305055 

These classes give you rhe practical expciience and ilie 
alii lily to interface with a [>rofessional instructor who has 
years of liencii ex[>enence. 

(n the next and fourth article of this series, we will 
examine the Pro Applicatitm Certifications that Apple offers. 
And in the fifth anidc, we will pnwide detailed information 
about the requirements for the Apple Certified System 
Administrator (ACSA) 10.5 ccriification. We wall discuss the 
tropics covered on each of the exams rec|uirecl for ACSA 
certification, and what resources are available to help you 
prepare. *rhose resources of coiir.se will include Apple 
Authorized Training Center clas.ses and books. 

\\\\ 


About The Author 

Doug Hanley owns litecTEK Consulting & Training^ on Apple 
Authorized Training Center in Las Vegas, NV His time h divided 
between teaching classes and wrangling servers. He has been 
providing support an the Mai since the early 90^s. To truck him 
down, go tu http://www.macfektraining,cofTi or emnil 
doug @Tn ac-fek. com 
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Upgrading to Leopard? 


Don’t forget to feed the beast. 

upgrade your system memory with Mushkin PerfectMatch to get the most out of OS-X Leopard 

It's a jungle out there when it comes to operating system upgrades and the ever increasing minimum system requirements 
for optimal performance. Now, with Mushkin PerfectMatch memory, you won't have to play guessing games and choose 
between the increased functionality of Leopard and your current version of OS-X. 

Because every PerfectMatch Apple memory module is built from components carefully selected to provide true compatibility 
and match or exceed the performance of the original Apple memory installed at the factory Which means you can tame the 
beast and confidently and easily upgrade the performance of your system to run Leopard. 






^PerfectMatch 

Memory to match your system perfectly. 

0 Guaranteed, 100% Compatibility 

Every PerfectMatch module is guaranteed to match or exceed the performance of the 
original memory installed at the factory 

© Save hundreds of dollars over the price of a new Mac 

Mushkin PerfectMatch memory upgrades provide an easy and inexpensive way to 
optimize overall performance. 


0 Taking care of your company's road warriors? 

Now you can cater to your laptop users' voracious appetite for RAM and enhance their 
mobile computing lifestyle. 

€ Your creative genius just met its match. 

upgrading with PerfectMatch memory increases performance in memory-hogging 
multimedia applications. 


Now That Cat Can Run. 


V i S 


us on 


n e a 


w ww mushkin com 


North America 


Europe, Middle East & Africa Asia & Pacific 


333 W Colfax Ave Ste 400 
Denver, Colorado 80204 
United States of America 
tel: (800) 569-1868 
fax: (303) 534-0827 


Raiffeisenstr.Q 
76672 Minfeld 
Germany 

tel; +49 7275-9888-13 
fax: +49 7275-9888-69 


B-13-9, Megan Avenue II, No12 
Jalan Yap Kwan Seng 
50450 Kuala Lumpur 
Malaysia 

tel: +60-12-3157008 


<m 

Get More. 





Managed Preferences, 
Part 2 


New options in Workgroup Manager in Leopard 


By Philip Rinehart, Yale University 



----- 

MacEnterprise.org 

Mac OS X enterprise depioyment project 


Managed Preferences 


A couple of months ago, 1 talked a little utx)ui all of tiic 
new cominami line options for Lrouhlcshooting Managed 
Preferences. In short, many new options are availahle for the 
system administratt)r. Well, even more love was given lo the 
Preference Manifest Hditor. New to Tiger, any preference could 
lie managed in ilieory, as long as the manifest existed in the 
aj^plicalion. In Let^pard, Apple engineers added some new 
abilities, many of which are quite powerful. 

Getting started 

To gel siartetl is pretty simple. It is explained in the 
Leopard server guide. However. 1 had to play with it a little 
lilt to really understand it fully. Another useful tip. [4;;‘f)pard 
Server is not needed to play with the manifests. How, you 
ask? It is aetually pretty easy. First, download a copy of the 
Leopard Server tools fmm the Apple downk>ad website. 

Install them, and launch Workgroup Manager. Now, imiead 
of actiially auihenticating against a server, click Cancel. Next, 
click View Directories from the Server menu, 

0 / I j @ , O _J 

Astrrttn A cfthint'v ^ Pff tfrrgncfi iRcfceshi Ne w Wipdow 

IwUdtrtctQfy: ^L«*l/Defaalt Not 


Figure 1 

A window similar to Figure 1 sliould apjK^an Note that 
die Local Direaory is l>eing viewed, here not an Open 
Directory server. Click the ifK'k to authenticate, and enter an 
administrator account on the macliine. For my testing. 1 
<Teaied a teslmcx user. This user will also appear in the 


System Preferences Accounts panel; the account appears as a 
managed account. So far, not .sc^ different from Tiger, right? 
Select a user, and click on Preferences. Notliing is managed 
imtially, as exjx'cted. Click on the Details hulton. Nothing 
af'ipears in the window. Now. here's wliere it licgins lo get 
interesting. Click tlie Plus bution. 'i'lic dialog lx>x asks for a 
locaLitin. Use the Command-G option to navigate to the 
/SystentAabrary/GoreServices directory. Next chtxjsc ilic 
ManagedCiient application. Wlioali, lixik at all of die 
applications dial can now l>e managedl Your WGM screen 
should lx* similar to Figure 2: 



Figure 2 


Pretty interesting, eh? Many of these preferences c^aonoi 
be managed via the stanebrd ITeferencc^s interface. 'Hte next 
question is iiow do you aciULilly manage these prefea^nces? 
Let's ItKik at two of diem. 

Folder Redirection 

As noted on AFP548.com. a very interesting option is the 
use of Folder Redirection, l^et's gei started. First select die 
Folder Redirection option, and click the Edit icon, At first the 
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Short Term Computer Needs? 


• Latest Apple Technology 

• Legacy Macs 

• Windows Computers 



Mac Rentals 


Event Technology Services 


• Rent One or Hundreds 

• Audiovisual Gear 

• Projectors, Plasmas, LCDs 

• B&W & Color Copiers 



• Name Brands 

• Nationwide Delivery 

• Professional Setup 

• Onsite Technicians 

• Same Day Service 



• Compatibility & Compliance Testing 

• Short Term Projects, Production Needs 

• Trade Shows, Conventions, Corporate Events 

• Trainings Sessions, Classrooms 

• Fortune 100 and Educational P.O 's Accepted! 


Toll Free 


800 - 756-6227 

Outside us/Canada: 858-454-8535 


For Online Quote Request, Visit: 

www.madcomputing.com 

Largest Apple Rental Inventory in the U.S.! 














Dictionary will appear to lie empty, 'Itiere's a bit of a trick to 
actually get it to work. Choose Always, and click the disclosure 
triangle so that it points downward. Next, click New Key. Still 
dtx.*sn'l kxik very interesting does it? How do you pick the right 
key? I lere's where the magic is, click on the new item. 


dictionary. Try it out; it's pretty self-explanatory once you 
understand die litde trick to get it working, Anoilier tip, in the 
window at the bottom of the Workgroup Manager screen, a full 
explanation of how the key is nsed is given. Fay attention to 
it, as it is written fairly clearly 


PreNfcncet 

Overvi^ H Oetitils 4 


ModilV application fn the prerei^nc^ftditor; 


PrEFenante JD 


Etluetooth 
Daihbodrd 
Desktop Picture 
Qt>£k 

T^ojder Redirection 
Home Sync 
Cal 
Chat 

Internet Conftpuratian 
FTunet 7 

Registration 
Kerberos Login 
Mail 

Mer^u Drtraa 


com .apple ,MCXB1 u etoolh 

com .apple .dashboard 

com .apple .desktop 

com-apple .dock 

com .apple.MCXRe^SrectDr 

com-apple.homeSync 

com .apple.iCaLmamged 

com .apple.jChat,Managed 

com .apple.tnte met 

com.appl«. (Tunes 

corn.apple. iWorkOR 

«du. m it.KerbeTos.Ke rberosLogin 

com.apple.maiL mar>aged 
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Figure 5 


Voila! ThtTC arc now multiple ways to redircci, login, 
logoui as siuwn in Figure 3- Select any one of them, and it will 
crcLite an array of keys limt are pre-ptjpuiated, Kca^p clicking 
New Key if ilic key is not a siring, hut instead an array or 


▼ other Redireoions 

r erray 

t ' fKHI* 

■ 's 'Redireci Actw : 

; : C - 2'. C 


Ac^en 

w swng 

Z deTe^AndCreateByrnLink 

DesOnaiion Raider Path 

• sJdng 

* /tmp^e^rt.ibrefyA^aches 

Folder Path 


i -rtJbraryCaches 


Figure 4 


Figure 4 show.s how^ a fully populated Redirection key will 
look, 'ilie default option Is io delete ihe folder in the local 
home direciory and pui in a syiiiixjlic link to the redireaed 
folder. One other note, how does the redirector know the user? 
For all of tliese manager! preferences, the %@ Ls used as a 
replacemeni for ihc cutrently ItJgging in user. From a 
scriptwriter's pers|X"CTive. this substitution is slightly different as 
script writers have gotten usetl lo using the $1 suhstiiution. 
One other note: this key can lx managed as Once, Often or 
Always. Not all keys can be mail aged this way. Let's look at 
one that can only be managed as Always. 



OvolabPhlink4. 


Multiple voice mailboxes. Personalized greetings. Full Mac OS X integration. 



Ovota b Phi ink is the uJtim^te message 
center for your Mac It answers phone calls 
and identifies callers using Caller ID and 
Apple*^ Address Book. It greets your friends 
with personalized messages. It records and 
stores messages on your computer - and 
even forwards voicemail to email. 
Featuring multiple voice mailboxes, 
high-quality audio. Spotlight searching and 
fax capabilities, Ovolab Phlink makes your 
telephone part of the digital hub! 


And you can fully customize Ovolab Phlink 
to do exactly what you need, using 
AppleScript: even set it up to call you back 
on your cell phone when important clients 
leave a message. 

Check rt out at www.ovotabxom. 
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ANIMATE WITH EASE! 




• Draw, scan or import artwork into system 
•Paint artwork automatically 

• Lip-sync mouth movements to voice tracks 
•Animate in conjunction with sound, effects 

• Access libraries to use and reuse content 
•Create motion and camera moves in 3D 

• Apply special effects 

• View animation in real time 

• Publish to TV, HDTV, video, web (SWF, QT) 


toonboom.conn 


ALL-IN-ONE ANIMATION SOFTWARE 


The only start to finish aniniation software 
toolset designed for creative and 
professional users. 


Teacher's guide and animation lessons available 













Merlin 2 

Project 
Management 
with 
a bit of 
Magic! 


Just three out of hundreds of features: 

Network-based Project Management 

^ Collaborate with others on the same 
project over the network. Just with a 
single mouse click. 

Automatic sync to iCal 

ryj \ Sync your projects to iCa! and then 
onto your iPhone or any other 
mobile device. 


Bluetooth 

Bluettx^th commonly needs lo managed in more secure 
envinjnmcnLs. In particular, the ability to even turn on 
Bluetooth may need to be disallowed. In this ca,sc\ try adding 
the key as Often or Once, Note that lliere are no options 
available. The Bluetooth managed prelerence key can only be 
managed Always. It makes sense if you think about it, as from 
a security standpoint a system administrator would always want 
it be off If you use die Always lcey» an option to Disable 
Bluetooth ai^pears. In my book, this ability is long overdue! 

Other keys can he managed, including iWork and 
QuickTime registrations, as well as a more extensive numi^r of 
keys for mobile computing. A couple of keys have solved 
nagging problems right away in my work, including the ability 
to control the Safari downloads location, turning off Alitofhl for 
Safari, and Open Safe Downloads, all things that can make 
more sense to manage from a semm 

One last thing, .since this article talks about how to use the 
local directory for management, lliese modiheations could lie 
used as pail of an image disiriliuiion mechanism, and not 
require Leopard Server. However, management in tliis way 
really isn't scalable, but might work for a test deployment to 
explore the new options available for system administration. 

Well, that's alx)ur it for I his month. I encourage you to 
explore the new options available, anti if options are missing 
that you would like tt> manage, make sure to submit a Feaiure 
Reciuest. Only through feature request submissions will more 
options he added! Until next month, 111 see you on the lisis! 

\\\[ 


About The Author 


Professional Cost Calculation 

Define Budgets top-down or bottom 
up and compare them to planned vs. 
actual costs. 

ProjectWizards 

Merlin 2 is built from 
project managers for 
project managers. 

Get your free demo 

WWW, merlin 2.net 
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Record. Edit. Play. 



00:01:08 rj 

MPEG Layer 3 Stereo 44.1 KHz D 


J] ITunes 






Using WireTap Studio, you can record the discrete audio output of any 
appiication, as weii as all system audio, or record audio input from any 
microphone, iine-in, or audio input hardware. 

If you can hear it, WireTap Studio can record it. 




Ambrosia* 

SOFTWARE INC 


Downioad your free trial now: http://www.AmbnosiaSW.com/MacTech 


Mac 


Worm with 

.mac 




WireTap Studio requires a Mac wltti an Intel^ Powerl^ 05, or PowerPC G4 (IGH 2 or faster) processor and Mac OS X 10.4 or later. 
WireTap Studio, Ambrosia Software, Inc., and the Ambrosia Software logo are registered trademarks of Ambrosia Software, Inc. All other 
brand, product, service, and feature names or trademarks are the prroertv of their rasoecUve owners. 















































Adobe CSS 

and AppleScript 


Upgrading iirt applicaiion, despite giving you aavss to tlic 
kitesi and greatest featiires^ temls to present ,st)ine nagging 
questions. Will your existing d(x:umenLs still work with the new 
version of the appliealion? Will any of your existing data, 
settings, or preferences be lust or overwritten? Will eonfliels 
with Ollier applicatitins or softw-are arLse? 

If you’ve incorporated the application into an AppleScript- 
based atiUirnated workflow', as is the case with many AdolK^ 
users, tlicn some additional concems may arise. Will your 
existing AppleScripts continue to work? If not, how long wall it 
take to update them? The answers to these <|ttestions depend 
entirely on the changes made by the applicatitm developer. If 
the developer has changed the application signiricantiy, then 
the AppleScript inipleinentaiion may also have changed 
significantly t<x). If this is the case, then many changes to y<mr 
existing scripts could Ix' necessiiry. 

Fortunately, Adobe* applications seem to have gotxl 
backward compatilnlity. In my experience, w'hen installing 
updated Adolie softw'are, I've generally found that only minor 
changes, if any, are reqLiired in my existing scripts. New' 
terminology may exist for new' application fcatures, hm exisiing 
terminology rarely seems to change much. And, if it dtxrs, then 
ifs usually well dcxaimenied. In diis intmih’s column, w*e1l 
explore some of the scrijxing changes in Adolx* Crealive Suite 
3, as well as provide some tips for upgrading your existing 
AppleScripts. 

Whenever upgrading an appliealion, wheiher it’s pan of an 
aulcjjiialed w'orkflow or not, its always a g<K)d idea to begin by 
backing up your existing data. Tlien, if you've got the means to 
do so, set up a test environment, where you may eonduei 
parallel testing w'itli the new software. Make sure it wtjrks as 
exjX'Cted, and make any necessary changes to existing 
AppleSc'ripis. Wlien you're sure things are working as 
exfxrted, ilien liegiti integrating the ufxlaied applic'ation and 
scripts into your live worklhiw. 

Acrobat 8.x 

'Ihroughout the AppleSeripl cuniniuniiy, it's widely 
as.siimed ilmt Adobe has ceased expanding Acrobat 
Professionars AppleSc^ript support, in favor of the ctoss 
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plaiform JavaScript. Therefore, Pm afraitl tfiat any new' 
scrifHing functionality in Acrobat Professional 8.x (which is 
included with CS3) is JavaSc ripbsixxifie. According to Acrobat's 
JavaScript API reference guide, Acro!>iU Profes^slonal 8.x 
ininxiuces a handful of new and mtxiilltxi object properties 
and methods. However, none of tliese aa* directly accessible 
via AppleSeripl. 

That said, you ctin access all of Acrobat's JavaScript 
functionality from AppleSe ripl by using the do script command, 
and p;is,sing it ihe JavaScrij>t ctxle you wish to execute or 
directing it to a file containing JavaScript ccxie. Just lx* sure tlxu 
you've enabled JavaScript in Acrobat's preferences. 

The following simple c*xample demonstrates how to u.se 
Acrobat’s do script command to I'etrieve the title property of 
the IVonimost opened document; 

U‘ll app1 tcjjtinn ’’Adobe Acrobat ProfesslonaT’ 
do script “this.info,titleU’ 
end tell 

-> "My Doctuneni" 

Acrobat Professional still ineJudes limited AppleScript 
supjjort tor |X"rforming ,some basic functions, such as opening 
d(>cuments, deleting pages, in.serting pages, and printing pages. 
If youVe got an existing script tJiat uses this terminology, then 
11 will pixjbably aintlnue to work. 

Acrobats Af^pleScrif)! tenninology hasn't Ix^n updated in 
quite some lime and it dtx*sn'i look likely to lx‘ expanded 
again iti tlte future. Acrobat's JavaScript support is far more 
rui:just, and for l^esi results and a greater chance of future 
cx>mpatibility, 1 recoiiimend using it whenever auu>mating 
Acrobat. You can lind a comprehensive guide to Acrobat's 
JavaScript terminology on Adolx.*'s develojx^r wx^bslte using the 
link provided later in tltis cx)lunin. You am also lest your 
JavaScript etxle within Acrobat itself by enalrling the JavaScript 
debugger. To display the debugger, simply type Command+J. 
See figure 1. 
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owe* Mercury On-The-Go^ 
Bus Powered 
Portable Solution 


owe® Mercury Rack Pro™ 
4-Bay 1U RackMount 
Storage Solution 


owe® Mercury Elite™-AL Pro 
FW800/USB2.0/eSATA 
Storage Solution 


Ideal for applleadons requirmg high data 
throughputs availability, and flexibility 
in configuration. 

t.2TB to 4.076 from 

8^ Hardware RAID, SoftRaid, JBOD options. 

• Available with eSATA, FireWire 800/400, and 
US82.D interface support. 

9 User customizable confif urations. 

9 Opto 4.0TB of performance storage. 


All Mercury Elite-AL Pro models are ideally 
configured for Audio, Video, Digital Photography, 
Professional Music, Graphics, General Data and 
Back-Up applications. 

2S0GB to 1,0TB from 

9 Up to 32 MB data buffer with data transfer rates over ISOMBsl 
9 Ultra^protective shock isolation system. 

9 Premiere BONDS utility software Included. 

9 Rugged, machined aluminum enclosure with super 
quiet operation. 


Safely and conveniently transport large 
amounts of data with no AC adapter needed! 

SOGB te 320GB from 

• FW B00y.ia0yUS92.0 to USB2 .D/oSATA solutions. 

9 Fully suitable for audio/video applications. 

9 ^uper quiet operation with shock isolation system. 

9 Premiere BONUS Utility software included. 

9 Compact 3 . 5 "(W) x S.S "(D) x I'TH) size and weighs less 
than 11 ounces. Fits In your shirt pocket! 
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Read AppleWorks 
Drawings 

With AppleWorks on life 
support, EazyDraw provides an 
excellent migration path to 
Apple's new iWork workflow. 

EazyDraw is a modern OS X 
Cocoa application, so it works as a full fledged 
team player with Keynote '08, Pages '08> and 
Numbers '08, EazyDraw can read AppleWorks 
6,x fifes and it can export native Keynote XML 
files. The AppleWorks import includes shapes, 
text, colors, patterns and gradients - even user 
designed AppleWorks Accents. 
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Make drawing fun on OS’-X with EazyDraw, the 
drawing application of choice for the Engineer, 
Scientist, Entrepreneur, Artist, Hobbyist or Educator, 
And yes.... it is as easy as using a Mac. 


Phone: 608 444 5245 
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Figure Acrobat's JavaScript Debugger. 


At the lime liiis column was written, Adol>c had not yet 
ofTii‘ially updated Acrobat Professional for Mac OS X lO.S 
Leopard. According to Adt>lK‘’s toipard capability guide, the 
estimated reletise date for thi.s update is s<)mtiimc in January of 
2(X1«. 

Acrobat Distiller 

Like Acrol)at fhofessionaK Acn>hat Distiller’s Apple-Scripi 
support remains unchanged in verskm 8.x. It contains a few 
basic tenns, the most useful I Kang the distill command , which 
may be used to convert a siKcified file to Vf)? fonnat, using a 
.sjx'cified PDF sitings File. 

Bridge CS3 

Bridge CS3 introduces basic Ap[>leScnpi support in the 
h>rin of a do javiLscTifX command. Although this may seem 
insignificant, like Acnilxifs do script t'ornmand, liiis command 
give.s AppleScripters access l<) Bridge’s extensive JavaSc:rif>l 
inijileinentaiion. 'llte following example crxle demonstrates 
how ID use lliis command to nm a slideshtAv of selected 
images, using Bndge's current slideshtiw options: 

tell lappl icat ion “Bridge CS3" 

do javascript “var thijirihs * app.dgcument .gotSelectioiit) J 
i3pp, riinSlldefihowCthumbs); " 
end tell 

Illustrator CS3 

Illustrator CS3 includes a number of AppleScript 
enhancements. Here are some that may lx.' of particular interest. 
For a (timplete list of changt's, clieck oui the llhisirator CS3 
Scripting Guide. 

CA>mmand.s liave l)een added For undo and redo. ’Lo 
undo the last txjx^ration, you would use the ft>llowing code: 

tell appTicatioti ‘Adobe Illustrator" 

UU^Q 
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Aqua Connect Terminal Server Is the only scalable enterprise 
grade solution that allows the Mac OS X platform to be 
deployed to multiple diverse devices, including Macs, PCs, 
and thin clients. Aqua Connect offers a feature set that truly 
simplifies OS X administration. 
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end tell 

'I'he path item cbss now pos,s€sses a read-only length 
paiperty, allowing you to determine the length of the path, in 
jK>inLs. Previously, you would have had to calculate this, based 
on tlte position of the f)alh's ends. 

tell application ’'Adohe TUustrator” 
tel 1 current docmnent 

length of ijath item 1 
Gild tGll 

end tell 

> l\b,}WhWm 

Open file and expori optitjns have been expanded. 
AutoCAD and Freehand open file options are newly accessible 
via AppleScript, as are AutoCAD export options. In addition, 
Jdiotoshop open options have lx;en expanded to include a 
preserve layers property and a layer comp property* 
flash export options have also been expanded to include 
additional prt>jK‘rties, including export all symbols, 
export version, Flash playback security, include 
metadata, and fnt)rc. Consult the Oirni Opium Suite and 
fixfxirt OpHom Suite in Illustrator's AppleScripl dictionary to 
access these clas.ses and properties. 

InDesign CSS 

InDesign CS3 only apfx^ars to have a handful of scripting 
changes. 'Iliis means tliai you should have few, if any. changes 
to make to existing i'SZ AppleSt^ripis, in order for them to work 
witli CS3. Primarily of interest are die following: 

The place command, wliich is used to place a file onto a 
page, spread, or [)age item, has Ix^en updated to return a list of 
items placed, rather than an individual item placed, llie reason 
for this change is that in sonie instances, the place coimnand 
may l^e used to place multiple (objects. For ex;imple, the 
fiallowing code [daces a specified image on two different pages 
in the active document: 

SGt thelBiagG to chaone file with pcorapt “Choose an image to 
placer" 

tell application “Adobe InDesign CS3" 
toll active document 

place theliT]Ei|'Q on tpage I, page 21 
end lell 
end tell 

> ItltnagG Id 218 of rectangle id 222 of page id 177 of 
apread id 172 of docuneni “Untitled-1“ of appllcofJon "Adobe 
InDesign CS3"|, linage id 223 of tGcLangle id 225 of page 

id 201 of spread id 196 of document “Untltled-I" of 
application "Adobe InDesign CS3"I1 

Tile resize, rotate, and shear comiiiands have been 
replaced by a mure generic transform command, wliiclt can 
be used to perform muhi[)le types of traasformaiions. To use 
this command, your script must first create whafs known as a 
transformation matrix, wliich will serve as the settings 
fttr tile transformation* A transformation matrix objea 
possesses varitius pro[)erties, such a.s horizonuil and vertical 
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In the old days, if you were designing web pages, you had two choices: a) make the type Look good using a bitmap 
— and lose the ability to have your text indexed, searched, copied, or spell-checked, or b) use a generic web font. 

That's history. With Photofont technology, your website can boast impressive typography, yet keep all the 
advantages of standard HTML text. Test it yourself at http://www.photofont.com m 


WEB TYPOGRAPHY 

Photofont*^ Webfteady’'” Lets you format web headlines and other 
short web texts with any fonts avalLabLe on your computer without 
damaging the original html So you can still search and copy the text 
and virtually every user will see your website the way you intend it. 
And search engines such as Google will like your pages, tool 

PMNT TYPOGRAPHY 

Our Photofont* plugins for Adobe Photoshop®, Adobe InDesIgn* 
and QuarkXPress® allow you to use photofonts in any print 
publication as well as on web pages. 

VISIT US AT WWW.FOMTtAB.COM AND WWW.PHOTOFONTCOM 


COLOR TYPOGRAPHY 

But Photofont® technology allows you to use more than just the 
normal fonts. You can also use photofonts with full color or 
grayscale, gradients, transparency and cool effects like those 
typewriter keys above (that's a photofont used in a web page) 

With BitFonter^**, you can make photofonts out of any digital image. 
Perfect for illustrators, scrapbookers, photographers or calligraphers. 

FONT EDITOR HEADQUARTERS 

Fontlsb Ltd. Is the world leader in font editors and converters: 
TypeTool^, TransType'^**, Fontographer'^^, FontLab Studio^*^, AsiaFont 
Studio^^, BitFonter^^* ScanFont^*^, and more. 


Copyrighi ©a007 by yontlab, Ltd. Inc. BitFmvtftt™, FomLab®. Ptiototoiil™, Typetoor«, FontographarTM, FontLab Studw™, AsiaFom Studio^“, TraniType^M *re tTftdem*rk« of 
Fontlab Ltd. Inc. TnDosign® and PhctoiahqpiS ar# registered trada marks d Adobe SysiemSi Inc. QuarkXPiess is a trademadt dOuuutk Inc. 
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scale, shear angle, rotation angle, and so forth, which inay l>e 
specified when the transformation matrix is created. 
These properties will control how the specified objects will be 
tran.sformed when die transform command is used. See 
figure 2, 
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Figure 2. The properties of a transformation matrix. 


Tliis is sure to conhise even the most experienced 
scripters. So, perhaps the best way to illustrate the iTtraLion of a 
transformation matrix and die use of the transform command is 
with an example. Hiis example code scales the selected page 
items in the active dcK'iiment to 25%. 

tell application ’‘Adobe InDeaign CSS" 

- Create a transformation matrix that will scale to 25X 
boriKontal and 25% vertical 

set thoTraJltor^atloiiMatrlx to make trans format ion matrix 
with properties (horizontal scale factorjO.25, vortical 
scale factors0,251 

- Get the selected page iLema 

set thePageltcms to selection 

Transform the selected page items using the 
iraneformation matrix that we created earlier 

transform thePageItems in parent coordinates from top 
left anchor with matrix theTranfotmatlonMatrix 
end tell 

Some addiiional related commands have also l>ecn added 
to Inlk’sign CS3, induding transform again, transform 
again individually, and clear transformations. 

Script Versioning 

InDesign possesse-s a unique foatune, wliich 1 have yet to 
discover in any other scripLiiile applications. This feature, 
known as .script vcrsitining, allows InDesign CS3 to run scripts 
that were writien for earlier versions of InDesign. Tliis mean.s 
rhal you theoretically should lx.‘ able to run your existing 
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laDasign CS tir CS2 AppleSt:ripls in lnl>e:iign CS3 without 
making any lurminoloj^ dianges. Actually, scripi versioning is 
not new to In Design CSi, and was around in CS2 as well. 

To utiliHe this feature, your script must Ixf written to target 
InDesign CS3| but use tenns from InDe-sign CS or CS21 utili/Jng 
AppleScript's using terms from clause). You must also set 
InDesigiis script preterent:es (via your script) to use the 
scripting implementation version appropriate for yt^ur script. 
For example: 

Target IiiDeaiga CS3 
tell application “Adobe Tnneslgti 

-- Change the scripting iraplementation version to CS2 
set verjslon of script preferences to 4.0 

Perform sooe CS2 code 
using terms froti "InDesign 

Add your TnDesign CS2 code here 
end using terms from 
end tell 

Please note that, in order kyr ilie code alx>ve to compile, 
you would netxi lo have ixjth InDesign CS3 and CS2 installed 
on your development machine. However, only CS3 would need 
to be insialted on the machine that will am tlie script. 

Photoshop CS3 

Like the tnher CS3 applications, Pliotoshop dtiesn'l 
intrcKlute a large numix.*!- of scripting ch;inges. Here ;ire a few: 


*lliere are now iwo sepanite versions of Photoshop, each 
with slightly different options, fhe version you have depends 
on the Creative Suite pat:kagc yt>u have purchased. Creative 
Suite Standard comes with Photoshop Standard, whereas 
Creative Suite Freiiuum comes with Phi>u>shoj> Extended. Your 
.scripts can now determine the version of Photoshop installed 
by u.sing the new feature enabled command. For example, 
this ccxle crhecks to see if Pliotosliop is ihe exlendecl version, A 
iTcxile^iii value is returned 

tell Application “Adob^ Photoshop CS3" 

feature enabled name “photoshop/extended" 
end tell 

true 

Photoshop Extended includes a new fciaire that alkrws 
you to manunlly count items in an image by placing markers 
throughout the image. These count markers are accessible via 
Appk‘Scri()i using the count item class. 'Hie following 
exaui|)le code retrieves a list of count items in the current 
document. 

tell application "Adobe Photoshop CSS" 
evt?ry count item of curreni document 
end tell 

'> (count item t of document *My Photo" of application 
"Adobe Photoshop CS3“, count item 2 of document **My Photo" 
of application "Adobe Photoshop CS3"J 

Photoshop now includes a refresh command, wliich 
may l>e used to allow the application to refresh prior to 
prtHieeding with further .scxipi execution. For example: 
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Deep Freeze Mac provides users with a clean and 
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tell application “Adobe Photoshop CS3“ 
refresh 
end tell 

Photoshop now indudus a Photoshop open dialog 
{■onimiind. When exeeiired, this coinmund displays P]iotosfu>p*s 
open dialog, allowing the user to dioose tlie desired files. See 
Figure 3- Kefcrenccs to tlie t Siosen files are ifien reiitrned to the 
script for furtlier pnKeSvsing. 

tell application “Adobe Photoshop CS3“ 

Photoshop open difilog 
end tell 

I file “Kaclorofib ltf5:lJ£»eri3:bwaldie:Desktop;Wy Photo, png'" 1 

_■. V ./.'i : ■, . . 



Figure 3. Photoshop's Open Dialog. 


Scripting Documentation 

Atlofx^'s scripting dcKimientation i.s quite exiensivc, and it 
ktT'ps getting l>etler with each new' release. When upgrading to 
CS3, one thing that youTe likely to notice is that much of the 
scripting documentation has l>een re-orgunii:ed and/or 
expanded. You can find the GS3 scripting ckKumentation in the 
following IcKatit>ns: 

Acrobat Scripting IXoimentalioti (JavaScript only) 

Online at 

http: / /www-odobe xom /devnet/oc robot/javoscript.html 
Bridge Scripting Documentation (JavaS<Tipi only) 

Online at htfp://www.adobe.ccHn/devnel/bndge/ 

On the CS3 Content CD in 

/Documentation/Scripting/Adobe Bridge CS3/ 
Illustrator Scripting IlcK’umentation (ApfileScTipi, 

JavaSc ript, and VRScTipr) 

Online at 

http: //WWW. adobe, com/devnet/ i 11 u strator/sc r i pti ng/ 

On the CS3 Content CD in 
/Documentafion/Scripting/Adobe Illustrator CS3/ 

Installed with Tllusiralor in /Applications/Adobe Illustrator 
CS3/Seri pting/E)ocu mentation/ 

[nDesign Seripting DtKiimentaiion (AppleScript. 

JavaScript, and VBScri]it) 

Online at 

http://www.adobe.com/products/indesign/scripting/ 

On the CS3 Conient CD ai 
/Documentotion/Scripting/Adobe InDesign C53/ 
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f^horosliop Scripting Docunicnlalitjn (Ap[>leScri[>t, 
JavaScript^ and VlJScript) 

Online at 

http://www.aclobe.com/devnet/photoshop/scripting/ 

On the CS3 Content CD in 
/Documentation/Scripting/Adobe Photoshop CS3/ 

Installed with Photoshop in /Applications/Adobe 
Photoshop CS3/5cripting Guide/ 

In CS3's scripting documentation, you 11 find example axJe, 
tenninology guides^ aitorials, scripting version liistories, and 
more. 

In Closing 

As weVe disc'ussed, the AppleSc'ript enhancemenis in CS3 
primarily offer AppleScript support for new fealures, or 
enhance existing support with new properties or parameters. 
Not t<K> many actual changes to existing support have Ix^en 
made> witii the exception of a tew bug fixes here or there. 
Because of this, it’s uniikdy that youH encounter major issues 
when upgrading icj CS3. However, it's still recommended that 
you conduct parallel testing and make any nece.ss:iry changes 
prior to iinplenteniing any new^ .software in a live workllow. 

As you coniimie st ripling the applications cjf the Adul'te 
Creative Suite, 1 k‘ sure to consult the scripting guides and 
documentation, as the.se are valuable re.sources thai can often 
help to clarify things and piil you Itat k on track, should you run 


into tr<ml>le, Adobe also lirovides online user-to-user fonims, 
wliich offer an excellent way to ask questions, find lips and 
tricks, network with other users, and more. Here, you'll find 
scripting-specific forums fijr all of the CS3 aj>plications. Search 
iliein often, and don't l>e afraid to pf xst questions of your own. 
http://www.adobe.com/support/fDrums/index.html 
Uniil next time, keep scripting! 
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't blush, but with review after review lavishing praise on the NewerTech* 
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Virtualization Bencnmarkirig 

How do Boot Camp, Parallels Desktop, 
and VMware Fusion stack up? 

by Neil Ticktin, editor-in-chief ] 


Virtualization 

Ptitt of tiiL* rL-ust)n imny )X\)ple own an Intel-baseci Mac \s 
Ixx'auac t)f die fKjssiliility of mnning Windows, If yon like 
nKJst, you a a* kxiking to tmdcrsiand ifie ciifTenences liem'ecn 
Apple's B<x)t CtiiTip, VMware Fusion, and Parallels Desktop. 

B(xh Camp, as you prtibably know, allows you to run 
Windows natively tm your Intel Mac, Here, Mac OS X is nowheiv 
It) Ix^ .seen, and if you want to switch Ixick and fortli, you have to 
relxM)t die niathine. As we've from some of the re<::ent 
i\‘[X>rts, a Mac am nm Windows faster than a native PC machine, 
and its a nice so!uii«>n, Tlial said, you prolxibly Ixjuglu a Mac to 
ntn Mac OS X a gtKxl chunk of time, and that's where 
virtualization cxjines in. 

VirtualizatMin leclinology^ lias Ix^en around since die 1960s. 
In general, it refers lo die alisiracLion of cxjniputer restjurcai. In our 
cuse, we’re laiking alxiut die ability to run Windows on a Mac at 
tlie Siinie time that you are mnning Mac OS X. 

The Big Question 

So, w^hich solution do you go widi? Dtx:s virtualization wx>rk 
well? Wliich virtualization pnxiuct Is faster? Should I am XP or 
Vista? In short, there am tiiHerent answ^ers for tiilTeaml fxsjple. It 
all depends on wliai your neexLs are. 

To tackle liiis firobleiu, MacTech undertook a luige 
lienchniarking paiject starting in September. 11ie goal was to see 
how B(X)t Camp, VMware Fusion, and Pamllels [XTfonned on 
dilTerenl levels of Mae liardwam, covering Ixith Windows Xl^ and 
Vista, and conijiaring tliat to a liaseHne PC mnning Windows. 

Sounds simple enough, Ixit w^hen you start to railize that 
rhea* wm' 19 ta)nfiguaitions of systems and a whole suite of tests 
dial had to lx- nin multiple times to make sure tliat we had gcxxl 
test v;dues, tliere wem over 2500 tests to be c'ompleted. In fact, 
during die tXHinx* of implementing diesc tests, IxHh VMware and 
Parallels txime f>ut witJi newer vei^ions. We tested VMware Fusion 
1.0 (51548) and PamlieLs 3^0 (5l60), and opted not to upgrade 
mid-way thixxjgh die test suite. Both of diese vc‘n»u>as should give 
a g<Kxi overall kuseline of comparison even with both liaving 
rclcstsed new versions. 

Ijet's tike a look at the results. 
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The Test Bench 

When we w^ere clxxxsing computer nuxJeLs, we set out to 
chtxjst- not the fastest, latest models, but ones that would be a 
gcxxl representation of wiiat mexst people rmiy have. Certainly, die 
faster models of diese computers will pt-rfortn even better. 

Similarly, we had a graiier fexus on XI^ simply Ixcause ifs 
more* pievident at diis point, but we did want to gel an 
understanding of liow Vista fierformed as well. 

'Ilie baseline we usc?d was a fjrand new^ iTijitsu Lifebook 
A6025, with an fnLel Core Duo running at 1.H6 GHz, 1GB KAM, 
running Windows Xl^ SP2. 

We chfxse i(m*e Mac nxxlels lo compare alongside a name 
brand HZ: a Maclkxyk, a Maclkxik Pro, and a Mac Pro. 

Tile MacB(X)k was a 2GB RAM niiichine. mnning a 1.83 GHz 
Qire Duo prexessor. 'llie Matikxik Pro W’^ls a iGB RAM rrmchine, 
mnning a 2. J6 GHz Core 2 Duo prtxes.sor. And, the Mac Pro was 
a 4GB RAM nuidiine, mnning a Quad Cote ainfiguration with two 
2.66 GHz Dual-Core Intel Xetan pnocessons. 

Test Types 

'lltere are three kinds of tests that we mn: one-step tasks, 
multi“Ste[i task teMs, and ciiiantitative Ixmchmarks. 

'llie fast set of tests was fcK'used on time to complete one- 
step tasks in Micro-soft OIfk'e 2(X)7, fnleniel Explorer, and 
Rle/netw'ork j/cx 'Iliese one-step tasLs mean that from the human 
point of view, once yoiJ clicked a mouse, or key, die lest would 
mn to completion without funlier human interaction. For 
example, laumfiing applications, scajlling huge doaiments, 
printing, etc. 

Tlie second set ot' tests were '^task tc'sLs" These weie 
primarity crexss platibnn, and ret|uired multiple steps from 
beginning to end. Tliese were kxtjsed on the interaaion berw^een 
Mac OS X and die virtualization environment. F(jr example, if you 
were to receive a PDF enclosure in Oudtxjk, and you wanted to 
open it up in Wtic OS X Preview; or yt>u wanted to dick on an 
email link in Safari, and you W’anted to use it to create a new email 
message in Ourlcx>k. 
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Tlie third set of tests jire qitvntitative tenchiiiarks using a 
utility to test CPU, graptiics, disk, etc.,. In our rase, we 
exj^eriniented with Sandra 2007 i:>enchinarks, but found the resLilis 
to lie erroneous and not usable for tlie viitualization environnients. 
We threw out these results and fcK'used on the first two sers. 

For tlicxse interesitxl in tile l)encimiarking meliiiKlologics, see 
the more tietailed testing infonnation in Appendix A. For the 
detailed results of ihc tests used for the analysis, see Appendix B. 
Bolli apfxjndices are also available on tlic MacTet h web site. 

Overview 

W'c won’t keep you in susiK^nscv In general, hen; am the 
coneJusioas, 

Wlien running the one-step tests descrilied alx>ve, on 
average, Parallels is 17% fa.steri.han VMware Fusion when ninning 
Windows XP, and 1% faster than Boot Camp. For die same tests 
under Vista, VMwaie Fii.sion runs 46% slower than Camp, and 
Parallels inns 44% slower than VMw'tire Fusion (1 lO^^j slower than 
Btxit Camp), For tlie task tests, Parallels is the dear winner over 
VMware Fusion — averaging over 6x faster than its comjXftitor on 
XP, and 52x faster on Vista. To he de^ir, however, this is not 
liecause of fxxir viraialization [icrfonnanee per sc, but the Wdy 
eadi product is designed. Parallels Is designed to liave die virtual 
mac:hine interact transparently with die host OS (Mac OS X). 
VMware Fusion, on tlic odicr hand, Ls designed on puqxxsc to 
keep the environments se[ianite. As a result, tliere are many extra 
steps you have to do .sometimes if‘ you are going hack and forth 
lx;twcen the IkxsL OS (Mac OS X) and the virtual madiine 
(Windows). 

VMware Fusion has the c'apability of creating a virtual 
mad line with two virtual pnxiessors. Parallels ticx;s not have that 
aipability. For most msks, iw'o virtual prcx:essors had no significant 
impact, and sometimes ran even slower than die single prQC'essf)r 
conllguration. And, even though we didn’t test it here, we would 
expect those applications dial can take advantage of multiple 
processors to am more quickly in a two virtual processor 
environment. 

In virtually all causes, we Ibund dial die faster Lite madiine, the 
less the differenc'e between hiraliels and VMware Fusion. Even 
more interesting is diat b(.ith prcxlucts could be faster dian Boot 
Cam[) in certain activities. For example, Pamllels was very fast at 
scrolling beating not only the PC, but also Boot Camp, time after 
time. Similarly, VMw^ire Fu.sion appears to have some type of disk 
caching or acceleration in its virtual hard disk wiiidi makes it faster 
than bodi the PC and Boot Ciimp. 

The Test Suite and Results 

The tests used were selected specifically to give a real-world 
view of what Boot Camp, VMw'are Fusion and Birallels are like to 
run. We eliminated those tests diat we ran dial i(K)k place in so 
short a time frame (e.g., fast) that we could not creite statLstically 
signilicant results, or that had impiTceivable differences. 

We did one test suite for each of die four major applicaUons 
in Microsoft Offia? 2007 for Windows, as well as a series of tests 
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technologies you need to untangle your 
Web infrastructure. Create powerful Web 
applications using Lasso's powerful, but 
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Figure K Microsoft Outlook 2007 under XP 
(shorter columns mean faster results) 


focussed on complex tasks cras,sin^> Ix^^een the hast OS and the 
virtual machine. Tlie ^oal is to ^ive users a gcx)d idea of wlial its 
like to use eacli of these apps. As a result, we came up with a list 
of tests that represented what we felt were the most relevant to 
regular ilsc. 

Tlie one thing tliat we did see across die Ixiard is tiiat 
Windows carries a great deal of variability witli it. regafdles.s of the 
environment. 

Outlook 

Of all ihc' applirations tested, Otukx)k is the only one that 
truly has no ajuivalcnl on llie Mac. Entourage Ls cjf course 
available, but it is not a "Mac version of Out]of)k’\ As a result, 
many people are tied to Outkx>k use ibr rarponite envifonmenfs 
or because it has ,some .specific feature set lliey need. 
Virtualization provides the perfect solution for tills ty[7e of 
situation. 

For Outlook, the one-step tasks tests included launciiing 
(ix>tli initial and successive launches), IMAP aca:)unt sync, ot^ening 
messages and printing messages. In addition, we tested sending 
e-mail, sorting messages, and searching, but found them to 
function kx> fast to test on even rite sltwesL macliine. 


Running XP, Pruallels was up to 189^) faster tlian VMware 
Fusion, and a bit huster tlian Iknt Qinip. Running Vista, Oiitkxjk 
tests ran alxiut identiail tor both Panillels and VMware Fusion. 

Fi^ire 1 .show.s the resulLs with nonTialized jK^rcentages. 
KXyX) is the Iraseline PC Ha>re, and die otlier limes are relative to 
die PC. 

Word 

of all the aiipliratioas, Word is probably the mo.si widely 
used. With Office 20t)8 tor Mac no longer sup|x>rLing VlfA, some 
users will turn tt> Oflfce 2007 for Windows under virtualization as 
a solution. 

1be tests relevant to mast Word risers are those that are 
repeated tliroughout die use of W(->rd. For j)nxJuctivity tests, we 
selected a variety of launcliing, scrolling, solving, End ik replace, 
opening files, and printing tests. 

The end result is that Word under XP tx^^rfonncxl nearly 
idenlit:ally on avcTagc ixtwc'en Parallels ;ind VMware Fusion ;md 
Boot Camp. Under Vista, Parallels and VMware Fusion were very 
close to either other, ]%ii lagged some behind B<x>i Camp. 
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Revolutionize 

your Lifecycle Management 
Strategy with LANrev! 


True Cross-Platform Lifecycle Management has arrived! 
Do you need to manage PCs with a Mac? Macs with a PC? 
LANrev is the first client management solution 
with true cross platform functionality 
for today’s heterogeneous client environments. 

Disk Imaging 
Asset Inventory 
Software Distribution 
License Management 
Patch Management 
Remote Management 
Role-Based Administration 
Change and Configuration Management 
LANrev TheftTrack Client Recovery 


LANrev is a scalable multi-platform solution, which can operate with equal efficiency on a single server 
deployment in the small to medium enterprise, or in a distributed architecture, managing thousands 
of desktops in a large enterprise. 

LANrev's modem, modular platform allows seamless integration into other desktop management tools such as 
Microsoft's SMS, enabling your organization to leverage previous investments while maximizing current and 
future efficiencies through the use of innovative new technology such as LANrev. The best part? You can take 
advantage of your current hardware infrastructure. Unlike the other guys, LANrev does not have massive, 
dedicated server requirements and you won't need a team of overpaid consultants to deploy and use LANrev. 

See for yourself how you can increase your IT efficiency and performance while lowering your cost by using 
LANrev in your computing environment. Schedule a free web demo and trial license by calling 
(214) 459-0136 or visiting wwwJanrev.com. 
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Microsoft Word 



Figure 2. Microsoft Word 2007 under XP 
(shorter columns mean faster results) 


flgun* slu>ws ihc R^sulLs with normalized 
Mfiii is the baseline PC setrre, and the oiher Irines are relative to 
the l^C. 

Excel 

Kor Rxcel, we watitetl to focus again on flie m<xst reptuitive 
tasks. For productivity tests, we selectetl fill range, scrolling 
vertically, sulitotals, anti auiodbmiatiing. 

1 fnderXP, Farailels was up to 21% faster than VMware Fusion, 
and 15% faster tli;in Lkx>t C;imp. Linder VLsia, it wils a very 
dilTerent story: VMware Fusion wits over faster tlian l^irallels, 
and B(X)T Gimp w:is 23% faster tlian VMware Fusion. 

The figure on tlte next page shows the resuiis with 
normalized percentages. Ls the baseline PC score, and Uie 

otlier times are relative to the PC. 

PowerPoint 

I'or Poft^erFoint, we fixaised on traasitioas: toth viewing 
them, and changing tltein en masse. Here, we saw nearly identical 
rc'sulLs of tile Ixiseline PC running XP, and fkxit Qtmp, VMw'ur' 
Fusion, and Parallels under btxh XP and Vista. (Tlic ckirt shows 


the difTeamces, hut you'll ncxice that the si'iilc is all witliin a couple 
of |x-^rcent,) 

The figure* on I l ie next page shows the resu lLs with 
nonnalizcxl percentages, KKfXj Ls the IrastHine K score, and tlie 
other tinK^s are Riative to the I*C. 

Network and File I/O 

(Jverall, the file I/O Ixiwc-en lkK>t Camp, VMware Fusion and 
Pantile Is were all very similar. At times, we saw lag anomalies on 
Parallels. We also siiw^ VMware Fusion's vim ml drive consistently 
jx^rfbulling very dose to a physical drive. 

Networking ft>r Ixiih viiiualization environments lagged 
Ix^hind IicK>t Gim[i, fxil w;is coasideiably fasier ilian our Ixise PC, 
One thing to note is that VMw-are Fusion liad prolilems sevenil 
times scoring very pcxirly using "sharing the htist’s amnection" 
(aka NAT). Out of eadi test batch, there w^as always at least one 
that scored more like we were expecting, and those liest cases 
were irsed for the chiiit. VMware Fusion did perform more reliably 
with a "bridged" eonfiguradoii. 

Parallels perfomied mudt more coasistenily aoxiss timings for 
a spedfic networking test, rcx^^alless of tlie type of virtual network 
acLipter ii.sed. Tlie figure shows tlie results with normalized 
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Figure 3. Microsoft Excel 2007 under XP 
(shorter columns mean faster results) 


Microsoft PowerPoint 
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Figure 4. Microsoft Powerpoint 2007 under XP 
(shorter columns mean faster results) 


WWW.MACTECH.COM 


























































DrrecTS, isolates and removes sp^mARE 



Your privacy, secured. 

Protect your security and privacy with MacScan, the 
premier Anti-Spyware software for Mac OS X 

Spyware exists--and it’s a growing threat to the online community. As 
the number of Mac users increases, so do the threats to your personal 
information. MacScan delivers peace of mind by auditing your 
computer for spyware and cleaning up clutter from casual Internet 
browsing to protect privacy and security. MacScan's Tracking Cookie 
Blacklist allows you to safely scan and remove known tracking cookies 
from popular web browsers. 
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Network and File t/O 



Figure 5. Network and Fite I/O under XP 
(shorter columns mean faster resuHs) 
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Figure 6. Internet Explorer under XP 
(shorter columns mean faster results) 


percentages. 100% is the kiseline PC 
sa>re, and tlie ixher lirnes are relative to 
tine PC. 

Internet Explorer 

For InLcniel Explorer, we ran tests 
rtx.ii,sing on loading cx)mplex wch pages 
from a local web server, and scrolling 
long web pages. Presumably because of 
ihc same netwr)rking variability noted 
above in VMware Fusion, Parallels 
jiertbrmed 55-60% faster tlian VMwart^ 
Fusion on average for both XP and Vista. 
Tile laige spike for VMware Fusion on a 
Maclkxik is a g<K)d indication for the 
network jKTfomtanc'e anomalies tliai we 
saw witii VMware Fusion as well. 
Parallels was also slightly faster than Boot 
Oimp, and afxHJl the sitme as the base 
IHl 

l1te figure stKws the results with 
nonnalizet! penentages. 100% is the 
baseline PC sct>re, and tlie other times are 
relative to the PC. 

Cross Platform Task Tests 

VMware i^’uslon and Pamllcls have 
very different designs. 

VMware Fusion Ls designed from the 
gnjund up to Ixf sqiamttd from die host 
OS. Stjnie have Gilletl iliis ""sand boxed"*. 
It lias die bencftli of keeping things very 
clean, and intuitive but most 
imptJrtantly seaire. You have to make 
real eflcjits for one OS to affect the other. 

Parallels is designed from ilie 
gniund up to have transparent 
Ixmncbries. 'lliis has die benefit of 
making ctcxss [ilatfonii tasks quite easy, as 
tlie barriers are kntxketl dtjwn. To test 
the titility of this tlesign, we cliose a series 
of multi-step tests. For tjptimiim results, 
many of diuse hatl to lie set up in 
Parallels preferences, or they wrjuld iiave 
pertbrmetl .similarly to VMware Fusion, 
For example, Parallels preferences allow 
yt>ij to you .set which OS is the primary' 
for handling web or mail. And, in version 
3 of hindlels, there arc now "lock dow'n" 
featurc^s that allow a virtual machine to 
inercase ""Lsolation", and ihcTeftirc allow 
less integration Ix'twc-en Mac OS X anti 
the guest OS (e.g., Window.s), 

TIk* tc^s that we timed were tvs 
follows. 
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rigure 7. Cross-platform task tests under XP 
(shorter columns mean faster results) 


Witfiin nn Ouikxjk ihvre was a PDV cn(:kKSiia.v 

l)t)u[)]c dick on rliis cntlusLiiv and ojx^n it within ilic WiikIows 
versicjti of Adolx* Reader. 'Iliis was our liaseline test. 

Similarly, wiiliin an OutliHik message, ()[X'n a PDF endosuic 
in Mae OS Xs Pan^'iew. For VMwarc Fusion, tliLs a^tjiiired nniving 
tile enclosure to the Mae desktop, and then opening. For Parallels, 
it could [yc conUgurt^l as a double click 

The saiiK* test for to open a Word dtK*unieni ent“k>sua* in 
Outltx)k in Micit)sort WorlI for Mac. Parallels allows cine to specify 
which applkation to t>[x*n regaalless of OS, whae VMware Fusion 
re(|uired ilial you move the endexsure to a Mac atressihle diretiory 
Ix'fore opening. 

If a user were to use Safari as a main hn>w.stT, liul (.)utk)ok as 
primary email, what would it kwjk like if they had an email link on 
the page? In Parallels, you ajuld click on the link and it would 
automatically open in Outkx)k with a new, atklres.sed iiiessiige. In 
VMware Fusion, you liad to copy the link, open fXitlook, cneatc 
the new message and then pa,sie the address in. 

If your primary mail ap[)iication was MalLapp tm die Mac and 
you got a Visio (,vsd) enclosure, you would need to open diat on 
Windows witltin Internet Rxplorer (with the VLsto pkig-in 
installed). Parallels (xnild do tills tntnsparently, where VMwarc 
Fusbn you had to move die file first before opening it. 


Lisdy, a MaiLapji message hiis a web link, and you want to 
open it in Internel Expk>rer 7. Parallels can have a Windows 
browser specified as the primary' lirowser, but in VMwanf Fusion, 
you would have to copy the link and jxist it into the Windows 
browsc-T. 

lk-*cause of the manual steps required tor VMwm^ Fusion to 
acromplish these tasks, Pandlels was substantkdly taster in all 
cases. Tlie cliari in Figua* 7 shows the msults as measured in 
seconds (e.g., unlike the oiIilt charts, diese are aclual times, not 
nomiiilizetl measiirenienls). 

Vista VS- XP 

Clearly most jxxjple ate .slill using XP. and not Visia. And 
cl^irly Vista doesn't jx^rfonu anywhere near ns fast a,s XP on the 
same litialwaa-. Hut, Vista is uUimiitely the futum for Windows, 
and over lime will gain gaunter atxrcptance, and therefom is 
something that we want to kc.‘t-‘p an eye on. 

Using our Boot Camp conrigiiration a,s a means for 
comparison, we found Vista mn 17-30% slower than the equivalcnl 
XF setup. 

By axnparison, when we compamd Xl^ configunations 
against die baseline PC, we got these results: 
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• XJ’ LinilLT licxil Cuinp averaged 12% faster than tlte 
IxLscline PC amning XP 

• XP under VMwnre FiLsion averaged 1% faster tluiii tile 
baseline PC running XP 

• XI^ under Parallels avieraged 19% Paster tlian tlie bsisellne 
]*C ainning XP 

Tlica* aa* tha’u ways to look at how Vista pertbrmetl in 
comparison to XP. Ibe fiist way is to compare VMwam Fasion and 
Parallels to Bool Camp. And the sec:ond way, is to compare Vbta 
tor c^ach vinual machine comjaared to the Xi^ perforirmnce tor ttiai 
siime virtual machine. Ibe third way is to !(x>k ai the t:om[)lex task 
tests which have to do mostly with the u.ser irUerl'ace of liie 
vjmiali7ali( m enviix>nments. 

Wltcn we awnpire VMwire PiLsion and Parallels running 
VLsta to the .s;ime mcxlei of computer naming Vista under IkxJt 
Gimp, here art* the averages that we got: 

• Visti under VMware Fusion averaged i6% slower than 
Vista under B(xh Citnp 

• Vislii Linder VMware I'usbn is 44% faster than Vista 
under [Parallels 

• Vista under Parallels averaged 110% sltjwer titan Vista 
under IkKX Gimp 

When we compare t?:ieh of the environments running Vista to 
the siime envin>nmeni ninning XI*, here aa* tlie averages that we 
got; 

• Vista under Bex a Qimp averaga! 24% slower than XP 

• Vista under VMware Fusion averagetl slower than 
XI' 

• VLsta under Parallels averaged slower than XP 

It’s a coni[)letely difleRait siory when we knik at VMware 
Fusion and Parallels nmning Vista for tlm multi-step lask tests. 
Since these tests fxx'us on user interface hicusing on the integration 
of Windows and Mac OS X afipliattiuns. it s primaiily hxiistxl on 
tile stejTs the human has to take, nor niw [irtKessing, Hcr*, 
Panillels is ct>nsistently 5x faster than VMw^aR 1-usion when 
l(K)king at crjss filatfonii task tests in Visui. 

Conclusion 

IkxX Cam]>, VMware Fusion and Parallels iiR^ all very gtxxf 
each in their own way. You shoukl make your dcL'lsioas I rased on 
what your needs are as a Result. 

11' ytni don’t want Mac integration, and just want to nin 
Windows, go with IkxX Gimp. It’s faster than a PC anyway. 

If you want a vimiali/xtion pR>diJci (iltai ulUws you to run 
Windows alongside Mac OS X), and you want the Ixf-sl 
[xrribnnaiKe for ilie tyjies of things that we tested, then clearly ycni 
need to am XP and not Vista. Furthermore, in our tests, Ixxh 
VMwiiR" FiLsion and Parallels fxjrfbnned well, and were a goixl 
us<:!r experience. That said. Parallels was somewhat faster in 
general tlian VMware Fusion for XP. 


If ytni want tfie Ixjsi virtuali/aition [x.^rform;ince for Vista, tlien 
VMwam Fusion is your choice. And, if you want to keep your Mac 
OS X and Windows environments ctimpletely separate, V’Mwate 
Fusion's design may lie ycHir IxHter choice. tAnd, although we 
didn't lest it, we would expect VMw:ue Fusion to have better multi¬ 
processor support if you really have an apf)licalitm that is designed 
to take advantage of it.) If your gtxil is tigiit integral kin between 
one or more Windows applications and Mac OS X, Parallels Ls die 
dear winner when running either XP or Vista. And, as we said 
befbre, if you want the lx.\sL XP fx:rlbnnante with the types of 
applicalions tested here, Parallels is not only fa.ster than VMware 
Fusion, Imt it’s faster thaji Bcxit Gimp on average for die 
applications that we tesrtxl. 

While many users are interested in ju.s! running a version of 
Windows, there aR' many applioiions for sptxrialized Vanned” 
solutions. Ibese are cidleti '‘virtual appliances” Clearly, VMware's 
iieritage shows here, and diey liave a very bnxid array of solutions. 
Parallels al.si:> has a variety of virtual appliances. For the user, it jiust 
a>mes down to wliat you aie kxiking for, and whidt vendor has 
the scilitrions you need. For moR inftmmtion on die vimial 
applbmccs that VMwaa" ofl'ers, see <hltp://www.vmwone.a>m/ 
appliance5/>. And, For more information on the virtual appliances 
that Parallels offers, .see <hltp://ptn.parallebxom/en/ 
pfn/dir/>'niere am additional reasons to chtxise one over another, 
indudiiig: for example, w4iich u.ser interface you prefer, and 
whether you frecfuenrly nin diffenenl OS .setu[i.s in your virRial 
machine. And, Ix-yond (he everyday Window's XP or Vista 
VMware Fusion also excels in tlie numlx^r of OSes suppoiTed. 

Atid, given tlie tiack retxird, exped all Parallels and VMware 
I’U.sion to Ixyih keep gelling Ixiter and Ikirt. Certainly, for XP, 
tx>di nm quite well light now. And, even widi differenceif in 
Ixjnchniark jxriibnnimce, the Vista exi'jenena- in lx>di Ls quite 
usable as well. 

Parallels 1 Jesklop Ls available from ParalleLs (fomierfy SWsoft). 
See <htlp://www,panaiysxom> for more infonnation. Pandlels 
Desktop 3.0 for Mac retails for $79-99. Parallefs IX-sktop 3-0 for 
Mac Premium Rdiikm including the IX*sktop version plus 3 
additional packages retails for $9*>^.99. 

VMw'are Fusion 1.1 is imiilable from VMware. See 
<hHp://vs^vA^.vmwarexom/moc> for moR inlbmititkm. VMwraie 
Fusbn 1.1 leUiiis for $79.99. To downlaid die spRadshtxii of these 
resuils, go to the Mac'Itxh ftp site at <ftp://flp,mc3clech.com/ 
src/mactech/vdume24_2008/>. For moR‘ infoniunion on how the 
Ix-nclinrarks vvur done, the nidluxlologies. and the ^suiting data, 
see <http://www. mactech.com/orHcles/moctech/Vol. 24/24.02/ 
Virtual izorionBendirnark/> 

7ill 
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The Road to Code 


by Dave Dribin 

There’s a Hole 
in Your Bucket 

Objective-C Memory 
^Management _^ 

Introduction 

Wclcoint! l)ack The Road to Code. In pruvioas iirticlefl. 
weVe talked alx)ui dynamic inemofy mamgenient and how lo ttse 
malloc and free in C. We've also tweieci using alloc and 
release in Obfective-C, Unfortunately, I left mit a lol of tfie 
details of Olijcctivc-C memory management, mentioning t:»nly tfuu 
alloc and release worked the s:mK" as malloc and free. 
'Uiis wdH a white lie, and tfie truth Is that they are a b\i moK: 
complicated. While the complioitions aa! a bit of a hurdle tij 
t)vercome, lliey i^aratloxically make it easier on the pn>grammer, in 
the long run. 

Object Ownership 


WeVe alkxiiled a Rectangle lastancx! at tlie Ixiginning of 
main so we just need to ieniem!)er to call release to dealloaite 
it at the end of main tefore it returrLS. However, as pre^rams get 
laiger and start running for longer pencxls of time, iIk’ task t/ Ihjw 
and wlien to release nieimiry Ixxtjnxcs daunting. You may have 
two olijeds that both are using ilie same Rectangle instance, for 
example, by showing the tetiangle in two different windows. TliLs 
would give you an grajih tliul kx)ks like Figure 1: 



Figure 1: Simple object graph 


l^ixh object_l and object_2 have references to the s^ime 
instance of a Rectangle class, rectangle. Wliidi ot^jea, 
object l or object 2, has die responsibility to release 
rectangle wlien they get released and deallcKrated? If neither of 
them aill release, then ytni end up in a situation like Figure 2. 


Ix*Fs assume, fora bit more, tim tiie alloc methtxl alkx'ates 
metiKjry for an obje'Ci and die release tnedKxJ imintdiiitely 
dealkx-tiles it. For die simple programs ve written so far, it’s 
eiisy to rememlx’r wlum to cnll release, lake this simple 
example where we use our Rectangle class in listing Ir 

Listing 1: Using the Rectangle class 

import < Foundationy Foundstioti. h> 
ll^import “Rectangle.h'* 

irit mnin (int argc, Const chat * argv[J) 

[ 

NSAiitoteleasePocj] ' pool ^ 

[iNSAutoreleaKePool alloc] init]: 



Figure 2: Leaking an object 



Rectangle * raetangle^ 

rectangle “ f (Rectangle alloc] iiiltXlthI.£ftX ; 

bottomV : 5 
rightX : IS 
topY r 10 ] i 

printft"Area ia Icectangie area]): 

prinif(“Perinteter is; [reetangle petiQeicrJ); 

[rectangle releaaej; 

[pool release]; 
return 0; 


rectangle new exists willi no txlier ol>jec.t |x>inmig to it, so 
It is lost to the system and taking up memoiy^ 'tills Ls called a 
nmnof^f kxik, and memory leaks are .sc^rioiLs bugs. Jf ycjy have 
memory kraks in a long-running program, sudi as a GUI 
application, then die program will lie using moa^ and more 
memory as it runs. J^retty soon, it aiuld be using most of die 
memory in the system. Tlas leads to a Ixid aser ex|xmence, as 
[iieruory Is lx:irig used for dead and no longer used objects, instead 
of usefiil stuff. 
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Okay, SC) dtraiiy na re]c.Lsinj( llscxI ()l>jms is a Iml Bui 
on ihe other end of the specmini of nienioty ptoblenis, you cati 
also over-rekuse an d)jea. Say Urn djth object_l and 
object_2 detide lliey sfiould lx: res|X)asibje for releasing 
rectangle. Now, if object_2 is adeased and dL'allcxatt'd, ii 
releases and dealkx'ares rectangle along with it. You end up 
witJi a situation like Figua: 3: 



0)|>.s! Now object_l is pointing to memory tliat was 
ptevitxisly used hy rectangle, Inii lues now lxx‘n derllkx■^Iled 
and returned to the system, lliis situation is allied a ckmgiir{i» 
pointer. Dangling pointer hugs manifest tiieraselves in strange 
ways and can lx.- fiaal to track down. Since mt^mory returned to 
the system may not Ix^ recycled and rc'^iUtxated ibr other purpose's 
rigliL awiiy, object_l might lx* able to use rectangle after its 
death. It will umtinue to W{)rk...ror a bii. But then, at some point, 
your program m;iy start actitig a'aliy stnmge or outright crash. 
Bec-ause the symptoms of tile bug are delayed - the bug actually 
occurred wlx're rectangle w^s pa^maturely released - these 
kinds of bugs are kird to squash. 

In order to avoid Ixxh memory leaks and dangling [K>inicrs, 
wc need to make sure that objeas are only cleallcxated after all 
objects pointing to them are finishetl One way to do this is with 
the cxincept of ownership. We can setup a system when* every 
oJijc'cl is owned by one and only one otlier object, and only the 
owner is resfXHisibje for releasing the object. Also, object 
ownership can be iransfeiTed from one of>jea io another. For 
example, take Figure 1 again. If object_l owas rectangle, 
then when object_2 is deiilkx'ared it does not take rectangle 
with it. If, on die otlier iiand, object 2 Ls the owner, it may pa,ss 
ownership to object_l. Thus, when object_l is dealltxated, 
it will lake rectangle with it. 

As you am Ixgin to .see, even from this simple example, the 
concept of ownership c^n lie liaid to manage. How do ytxi mxify 
ob ject_l tkit it now owns rectangle? What if a tliiid oliject, 
object_3, is created Ixfore object l is de;illocatcxi and tt also 
uses rectangle? ob ject l needs to stimehcw know^ alxHtt this 
and traasfer ownership, iastead of releasing rectangle uixm 
dc*alkx;tlion. Tliere arv ways to maaige the single ownersliip 
problem, but tliey can lx* difticiilt to get right, 'lliankhilly, 
Objective-C gives us a better way. 


MACjm 


Reference Counting 

Itisieiid of liaving single rwnership, with one and only one 
owner, Objective-C embraces shared ownershifi. Ihus ob ject_l 
ami objeti_2 ixxh ow'n rectangle, rectangle tloes not need 
to know wIk) iLs owners are; it just meets to keep mtek of' tlie 
numixr of owners. Wlieu the riumlxT of owners dn)ps to 
then ifs drallcx;itetl. ‘Ilie numlx^r dl owners is called a nfenmof 
count since it counLs how^ many (Xher dijecis tefca^ncx^ (point to) 
it. IVe mtxlifted the original oltject graph in Figure 4 to also show 
the reference count of rectangle, llius when object_2 
alea.scs rectangle, it decamients the referena* cxjunl From two 
to one. .Since iJie rcfcrcncx* count is still ga*:tter than ?cro, it is no! 
dealliKUted and Is awtiJable for ob ject_l. WIk'h ob ject_l also 
releases it the reference count will be ?x*n:>, and rectangle will 
ftnally lx* dcalkxuled. 



This alwj fixes our situation w'hert* ob ject_3, w^hidi also uses 
rectangle. Is cTcalcxl Ixfoa' object^l nelatst^s rectangle. 
'Ihe reference aiunt for rectangle grxjs Ixtck iif> to two. Thus if 
object_l releases rectangle, tlie rdeamce exxint will lx one 
atxl it will live until ob ject_3 also pelra.ses it. 

Okay, so tliat’s the thc*ory. How do you actually list* reference 
counting in Ohjective-C? YouVe already Ix^n fxiitially using it. AlJ 
objects that inherit from NSOb ject (which are all objeas) already 
contain a reference count. The release merhml does not 
deallociite tlie memory straiglil away, like die free function dtxis. 
lnstt''a{I, ii suhtntets one from die ref'enencx^ txxini, and tinly il' die 
new reference count Ls iiero will it dealkxate the memory. 

So release decrements (reduces) die mference a Him, but 
hr>w do ytHi inciease the reference count' Wlien an olijea Ls 
CTcaled widi tlx alloc it Ls given a referentx* count of’ one. Itius, 
if we look at our program in Listing 1, you II .see why releasing 
rectangle deallooites it. If you neeil to iixieasc* die refcTentc 
cxHini there Ls a methtxl called retain thiit does just this. Because 
Ohjettive-C uses die retain nxllKxi, the reference* count in 
Objective-C Ls also ailletl the rekiin coimL Same thing, tliftercnl 
name. In fact, you can even get the letiin count of an oJ)jet.t with 
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tlie retainCount method Ij.sring 2 demoastralc^i tlie attain 
anini. 

Listing 2: Retain counts 

jj iiiip<irT :■ ouradation/FiJundation. h} 
if import “Eectangle-h” 

int main lint argc, conBt cbar * srgvfl) 

I 

NSAutorel«?asePool * pool " 

f [NSAutoreleaeePool ailocj inltj: 

Rectangle * rectangle; 

roctangU " [fRectangle alloc] InltWlthleftX ; ^ 

bottomY 1 5 

rightX : lb 

lopY ; 10]; 

printf(“Rotfllti count: %d\n"^ trectangle rotainCount]); 
[rectangle retain]: 

prinLf{''Retain count; %d\n'*. [rectangle retainCount]): 
[rectangle fwIgoboI; 

printf ("Retain count: %d\n'‘, [rectangle teiuinCouniJ): 

[rectangle release]: 

[pool release]; 
return 0: 

\ 

Wliun mn, ihLs program will tRUput: 


Retain count; I 
Retain count: 2 
Retain count: i 

As an aside, while using retainCount cun be interesting Uj 
see how reference counting works in 0]>jcttivc-C, you should only 
use it for del nigging purposes, Tliea" are cuses when ihc retain 
amnt Ls not telling tlie whole story^ especially when aintnelLase 
pools (discussed lielow) ctjme into play, 

Willie Objective-C luis built in sup(x>rt for shaied ownership 
via reference counting, it is still an exj^lkii step that all Objective-C 
prognimniers need to use pniperly If you lake Liway only one 
thing from this anicle, lei ii be lliis rule: every alloc and retain 
miisi l>e tralanced by a conesfxjnding release. Thus, in the 
example alxive, Iiecause we alk^ate the ob^xi and retain it once 
more, we need to reit^jise it iwic^*. 

Since ii Ls a manual step, you can still get nieiiiory leaks tf you 
foigel tt> Release* an d>jea after retaining it, and you can get 
dangling pointers if ycxi revise an object wiilKnii first retaining it. 
Because the progmmnier must explkilJy maiiage the referenc'e 
t^>iinl with Rtain ;ind mlease, this Ls called manual rejemice 
amntiug. Other bingiiages, such as l^ythtm, have automatic 
Inference cminting, whem ihe language lakes cur of incrementing 
and tk‘crefTH.‘nling ihe RfcRtice count fur you. Mas, we Objeclive- 
C pn)graimTiers have to do it manually, but at least we have it fxater 
than straight C programmers. 
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Retaining and Releasing 
in Accessors 

Lisiing 2 ifi noL a iralisdc usage of leuiining and nclcasing 
ubjecis, thougli, as you rarely retaiu ati ol:^xt lor iio reason. Tlie 
re^ison you would mrain an ol^ect is to take slmred ownership in 
it. let's create a new class tailed RectanglePrinter that holds 
onto u Rectangle in.sumcc and prints infomiaikm aixjui II 
Listing 3 shows tlie interhtce Ibr this class. 

Listing 3: RectanglePrinter-h 

llmpori' xFoundaiiots/Fo'h .1lon*b> 
ft report ‘'Rectangle, h" 

§interfac€ RectanglePrinter : NSObject 
E 

Rectangle * reetangle: 


- (Rectangle *} rectangle: 

- (void) setRectangle; (Rextangle *) rectangle; 

- (void) printAren: 

^and 

lb use tills new cLisSj let’s use tlie test program in Listing 4, 

Listing 4: RectanglePrinter test application 

firaport ■I'cjundati on/Foundation ^ h> 
ifimport "Rectangie.h'’ 
ftmport "RectanglePrinter. 

int maindnt arge* const char * rargvt]) 

E 

NSAutoreleasePool * pool = 

L[USAutoreleasePool allocl initj: 

Rectangle * rectangle; 



START 

FAXING! 


rectangle = [rRectangie allocl initWithLeftX ; 5 

Uot LoniY : S 

rightX ; 15 

topY : IDl; 


RectanglePrinter * printer = 

[ [RectanglePrinter alloc] Inlt]; 

[printer setRectangle: rectangle]; 
[rectangle release]; 
rectangle ” nil; 

[printer printArea]: 

[printer release]: 

[pool release]; 
return 0; 


Lut rue ix)int out a ct>uple of tilings Imv, First, aftur calling 
setRectangle:, we release our instant'e, since we iire no longer 
in need of it. This does not deall(x:ate rtx:liingle, though, since 
setRectangle; sliould take additional ownership and maease 
tile retain «}unt. We also .set rectangle to nil after its release, nil 
is a sptxrial value that am lie assigned to any object |X)inter^ and il 
meaas the pi>iTUer jK)inLs lo no objea at ail. It’s g<)(Kl [iractice to 
set your object jxiintei's to nil after televising them. While it wont 
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imtter if youVe written your program without any bugs, it can help 
while debugging if youVe ni'ide a mistal^e dealing with the retain 
a>unls. 

Before ciiviiig into the implementation, tlieiels a little more 
temiinology to coven Keinember th;it instance variables are private 
and should only Ix^ used intcmally to the class. If you want u> 
make an instance variable, like _rectangle, available ouLside 
your class, you should use methods to keep encapsuiaiioo intact. 
Tlie pair of methods, rectangle and setRectangle s, expose 
the _rectangle instmce variai)le pul)licly and are called accessx^r 
methods. The rectangle method is called a getter and 
setRecangle: is called a .veffer. 'l1ie getter and setter pair of 
acfesstjr melh(xis is an iinporlanL design paLlern that we will be 
seeing more of in advaiiced Objective-C topics. 

Mhe implementation of RectanglePrinter shows how^ to 
use retain to take (ownership for access<3r methods, and is shown 
in Listing 5. 

Listing 5: RectanglePrmtenmj first version 

fjfiroport '■RectanglePrintec.t" 

fiitipleinentatlon RectaQ^lePtint^^i: 

- {Rectangle ■') rectangle 

return ^rectangle: 

I 

- (void) setRectangle: [Rectangle *) rectangle 

I 

if {rectangle ^ rectangle) 
return; 

Lrectangle release]: 

_rectangle = [rectangle retain]: 

I 

(void) printArea 
I 

prlnttC“Rectangle area: %,2f\n". l_tectangie areaj ] ; 

I 

@ertd 

The rectangle mcthtxl is simple: it just rctums ilic 
_rectangle iastance vartiblc. ^fliis is how tiiusl getter mciJiods 
should be implemented. 'Ihe setRectangle: meiJi<xl is a hit 
mom itimplic'iitctl, though. Notic’e that retain also reutrns the 
object, iKJ you can [X.'rfonii die retain and assigniricnt in a single 
step. You might be tempted to implement it as Ibllows, by fust 
releasing the t unent rectangle, ancl the retaining the new' one: 

(void) KetRectangle; {Rectangle *] rectangle 

[ 

[_rect«ngle release]; 

_rectangle = [rectangle retain]: 

] 

However, donl do it! 'Hiis cmises issues if the new nxtangle 
is the same instamx^ as the old one and the airrent retain count is 
already one. If diis hap|K*ns to be tlie case, rc'leasing die t)bjcci 
would cause it be deallocued IxToie tlie retain hipjiened, and 
youd end up retaining a dead object. While this does not happen 


very often, it can liappen, so it’s wise to follow tlie pattern in Listing 
5 and check for idemical instances in all your setters. Inhere are 
otlier coraxl ways of writing at:ct!ssor mellKKLs, and indeed Uie 
Vxjrrecf’ way Is still a topic of deliate, but die pattern covered here 
covers die vast majority of situations. 

Destructors 

Tliere's sdil one more bug lurking in this code. If chilling 
release on a RectanglePrinter c'aiisc-s it to be deallcxatcxi, 
the Rectangle iastance ix>inted to by die _rectangle mstanc'e 
variable Is leaked. ITiLs Is bcouse we did a retain in 
setRectangle: but nevcT paiixxl this up witli a release. Wlial 
we Really need is a way to be notified diat our olijea is alxxit to lx 
deal]negated .so we can clean op any objecis we’re using. 
Tliankfully, Objective^; calls a mctlicxl named dealloc jusl txfone 
dealloaiting your object to give you a chancre co do just dial. Here’s 
how we WTxdd implement it; 

■ (void) deailoc 
I 

Lret^tangie release] ; 

[super dealloc]; 

[ 

Ikctiuse dealloc is called when die d>ject Is just aixxit to be 
reclaimed for system usage, it is allied a destnuitor Ihis 
temiinc^logy also pairs up with the init meihcxl Iseing allied a 
constructor, as we Udked alx>ul in die pRvkjus article. 

You may be wtjndering alxiut the case where _reGtangLe is 
nil. Oil ling meihtxls on tjhject.s set to nil ckx^s nothing at all. 
Thus, it's safe to call release on nil. Thi.s may seem (xld if 
you’ic coming Ifotii a C++ or Java Ixickground wheie ailling 
inethcxls on an objea set to null (dieir equivalent of nil) will 
cause your program to crash. This is one of the cxldball Objective- 
C nujinenls. Sotiie petjple love il and some ]xoi>le liate it. 
Wliutever your take, you imty as well just live with it and embrace 
it, Ixc'ause ifs ncx going to change. 

You may dba lx wondering what _rectangle is ,sci to if you 
never call setRectangle:. All instance variables are set to nil 
automatically by the default coastmetor (the init merhexj of 
HSObject), so our etxlc^ will work just line. However, some 
people like to explicidy set objects to nil iti a aistom constructor, 
listing 6 shows die complete implementation of 
RectanglePrinter, compleie with tx>nsinicior and dcstnielor, 
acccs.sor inetluxls, and printArea. 

Listing 6: RectanglePrinter^m, complete 

^import ** Rectangl ePr inter. 

#iinpl€^nK‘ntittion RectanglePrinter 

(id) Init 

I 

self ^ [super init]; 

If (self nil) 
return nil: 

_rectangle = nil: 
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cetarn aelfj 

\ 

- {void} dealloc 
( 

Lrectangle releasel; 

[su[ier deallcK:); 

* 

(Rectangle *J rectangle 

! 

return ^rectangle- 

] 

" (void) HeiRectangle: (Rectangle *) rectangle 
f 

If (recLangie = _rGCtftngle) 
return; 

Lrectangle release]; 

^rticiangle = i rectangle retain]; 


- (void) prlntgrca 
( 

printf(■'Rectangle area: Lrectangle area]): 

I 

#end 

Retain (Cycles 

Wliile i-eferfricc c:<)untin^ is an efiectivt? technique lo tu'fp deiil 
with memory managciiK^nt, it am hre^ik down in one case, [f iwo 
d:)jecLs IxRh referena* c*ach other, you end up with a situatitin 
where the regain count will never raich a:eK>- Tins is lx,‘c;uise their 
retain cx>unts will lx: stuck at one. Figure 5 shows ht>w Uiis can 
happen, where parent and child retain each other (see lx*k>w): 



Figure 5: Retain cycles cause memory leaks 


When object_l is deallocated, it releases its refea^nce to 
parent. However, since child alst.^ references parent, the 
retain a>uni <an never aadi ^ero, and we’re stuck leaking an 
instance of Ixjdi parent and child 

The trick to tliis Ls to have child contoin a reference to 
parent, hut not attain it. Tliis is tailed a tvmk wfemtee. By 
having child not retain parent, the reference cxxint for parent 
is only one, as in Figure 6. 
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varbible. They may need to create a new object on die fly. Take 
this method dial a^aims a Rectangle oiiject that is a 4x4 sqiiaa: 

(Rectangle squaxe4)t^ 

1 

Rectangle * square ^ 

[iRectangle sllecl inittfithLeftX : 0 

bottrtriY ; D 

rlgttX : 4 

topY : 'd: 

return square; 

I 


Figure 6: Using weak reference to break retain cycles 

Tlie key for this to actu^illy work in practice is to expbin, in a 
cximment, tfuit it is a weak reference, so that other develojx'rs will 
understand wliy a retain and release ate not done on diis reference. 
An example is shown in Listing 7. 

Listing 7: Weak references 

liinpQrt vQxroa/Coccja.h) 

telass Parent; 

Sinterface Child ; NSObJect 
I 

// This Is 3 weak reference, Po not retain* 

Parent ’ _parent: 

I 

■ (id) initWithParent; (Parent *} parent; 

(§end 

Delayed Release 

Someiinu*s getter inetlicxls do nor simply rtium an iastanc'e 


Ihis kx>ks very sinukir to any other gt*tter metlicxl, except tlie 
caller is sup^xised to release the objeti when it is done widi it. Bui 
liow is tile caller .supposed tti know^ tills? We cotild dcxiimenL diis 
in the code ciirnmeoLs, but tliere's a high probably dial jxxijile will 
miss this. Or we could rename the metlnxl such tliat it indicates 
ofjjcxt creation, such as newSquare4x4. But this limits our 
imt>lementation choice's in the futuie, What if we decided to use 
m instance variable to keep returning the same olijcxt for increased 
pedonnance? Well have to change our nanx" to squaxe4x4 
so as na to conhise the Giller, Tfie solution to this Is lo ase tlK* 
autorelease metfuxl .supplied liy NSObject. Tlius the correct 
inipk'iTienlalion of square4x4 Ls; 

(RecUBglc *\ f;quare4x4 
t 

Kc^rtangle " square “ 

ItRertangle alloc] in ItWithLeftX : 0 

bottomY ; 0 

rlghtX : 4 

topY : 4): 

return [square aututelease] ; 

I 

'Ihe autorelease iik'LImxI is similar to release in tliat it 
will decrc'a,se ihe mference count, Ixit at some jxiint in the ftiaire 
iiksiGid of iiiimeduitely. 11uis, 11' the giHct dcx"s not keep a reference 
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i£> the return value, llie ohjtxt will projXTly PL^teased. However, 
if hie Oilier dim reUiin tlK" retiim value, then the retain count will 
still only lx: <tne. It will temporarily lx: two, hut the delayed release 
causes the letain count lo go hick to one. 

How does this aiitorelcasc thin^ actually work? TIh: scx'iet is 
autoielease [xxiLs, implemented by llie NSAutoreleasePool 
cbss* Yup, those are the £)i’)jetts we see in our main class- When 
the autorelease iiieLhod is ealled, the object geLs addcxl to the 
most ctirtcni autojneiea,se pool Whvn the fXK>l Ls relecused, it also 
rele;tses all objects in lire pool. Titus, in our simple prcjgranis, the 
delaytxl release exeunt just Ixdbre the main appliculion exits. 

BeeaiLse autorelease may by used iniemally by pans of ihe 
standard Foundation library, includinj^ NSObject, every 
applic'iition needs at ieiisi one autorclease pcxrl active at all times, 
ilial's why the Urst thiii^ our Ol>jtxtive“C programs do is set up an 
automleasc jxx)L We want toeasure an autonedease pool is itr [)lace 
Ixfoie we start using any other objects. It's also why the last thing 
our program does is Kieasc llie auiorelease pcxrL 

In <jUI applic*^lf^ons, you don’t need to setup any aLitoreleiisc 
p{K>Ls. rile standimd txxxia libmries take c''^ire of all this for you. l-'or 
our cximmand line appliculioms, thougli, we need to lake care of the 
auforeleasc* pcxiLs, ourselves, 

Autoreiease aiid Class Methods 

TIk* iikiIkkIs we have Ixen using .so far only work on an 
in.stance of that da.ss, thus they^ aie culled imiuna^ metb(^ds. Iliea’ 
is another kind of nietliod that dex^s not require an instance of a 
clasvs calkxl class methods. Tlicse are declared using a plies C+') 

iastead of a minus sign as the hrsi cliaracter: 

+ (voldl myCliissMethod; 

The definition also uses the plus sign, but Ls otherwise^ identical 
to an iiistmice inethixl: 


+ (void) ttiyCUssHethod 
t 

prinlft“ln myCiassHethodVn")i 

1 

Since you ckin't use an object iastanc^ to cull these metlxxis 
on, you use tlie class name w!ien c’lilliiig class methods. l"or 
example, if the alxive class nietlnxl were part of llie Rectangle class, 
it would lx* Hilled like this: 

[Rectangle myClas^Methodl; 

Class mellxxls, because llicy dt> not reciuire an instance, are very 
simikir to a funclion call. 1he IxfneFil Ls tliuE the are tied to a piirticukir 
ebss. Wlxnlier you create a ftinction or a cktss nK?lJKxl lenlly ciepends 
on the sinuuion. One fxinkiilar cu.se where ckiss methods are usekil 
Is for crcaiing anronelHised iasrances in a single step. 

Beatiisc autoR:ku.sed objects tmike memory maniigement 
eiisier wfien ytxi use short-lived objects, they leixl to gel itstxl a lot. 
I lowever, enuring them can Ix^ a bit a pain. For example, to cTeate 
an autotvleased instance of our Rectangle da.ss, we need to call 
iliret: methexLs: 

rectangle " HRectangle alloc] initWithLeftX : i 

bottoniY : 5 

rightX : IS 

lopY : lOl; 

[rectangle autorelease]; 

To m;ike diis conunon task easier; it is useful to create a class 

ihclIkxI that dtx:s tills all in one step: 

+ (Rectaiigle ') r&ctangleWithLeftX : (float) leftX 

botfomY : (float) bottomY 
rightX ; (float) rIghtX 
topY : (float) topY: 

I 

Rectangle " rectangle = 

(laelf at loci InliWitbLet’tX: lefrX 
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bottoiflY j bottomY 
rightX : rightX 
topV : lOpY]; 

return [rectangle auto re lease] ; 

\ 

Tliis could then Ix! used like: 

rectangle " [Rectangle rectatigleWithl^ftX : 5 

bottomY : 5 
rightx : 15 
topY : 10]; 

YtHi will see this “dass mcLiuxI ft^r autorelease" paiicm in 
many of the smmktrd Foundation and QKX>a liliraries. By 
convention, the name t>f tJie class metlitKl slaits witli the name tlte 
class. For example, tliere's an NSKmnber class in h'oundation lliat 
holds standard C numbers, such as int and float. To create an 
instance of this, you would use: 

NSHumber ‘ nutnber = [fUSNupber allocl inltWitlilnt: 4211 

To create an aiitorelcused instancx", ytiu wotikl use the 
numberWithInt: ckss nietkxl- 

NSNumber • number - [NSNumber numberWithInt: 43): 

I mention tliis k-cause the pattern is so lieavily used that the 
dtx'umentaLitm t)ftcn fails to mention liie fact that the Mum olrjeci 
Ls autorelcased. So just keep this in mind if you see ctxle like tills 
and ytHJ are wondtiin^; wliy release Ls not k^ing la^lled on these 
objexts. 

Garbage Collection 

While refemnee counting Ls a big step u[) from the malloc 
and free usage of standani C, it c'an siiil k prolilemaik; es[x^dally 
sinev Olijective-G uses manual txTerence cxxrniing. It Is easy for a 
pRigrammer to forget to call release and cause inemoiy leaks. 
PropTly using retain and release Is yet antithcr tiling 
pnigrammeis have to think alxjut, instead of how to ini[^iement 
new featiiies. 'niatikfuily, tliere exisis another icxiinique for dealing 
with dynamic iiKanory. 

C)bjective-C* 2.0, whicfi was idejised along wiih Mac OS X 
10.5, Let>]>ard, includes a technique cxilled gatiMige aJImion. tn 
short, gJirl^age a>lleaion, or GC, wt>rks ly Ixiving the .system keep 
tnti k of all alkx'arions and ^LSsignnienLs. 'Iben, lire systan 
will [Ksiodolly st^n all alkKiilcxI objeas, looking fur olijects tliai 
have no references to Uiem. If an object has no lefenmcx^, it Is 
cx>nsitlered garlxige and dealkxxiled aulomatiailly 

In plain HnglLsh, ihLs rneaas tliat you no longer have to use 
retain, release, or autorelease t^er again. Memory 
niinagemenl Ls ctMiipletely autonritic:, arid the burden of memory 
leaks, dangling [Printers, and retain cycles has been lifted from the 
kicks of OlYjeclive-C piogratnmers. lilts Ls re^tlly huge. 1 lere is oiir 
RectanglePrinter test appliaition fnnn LLstbig 4 written with 
gaiixige cx)Qection: 

Listing 8: Garbage collection example 

Ijapa rt Founda11 Poundat ion - h> 

fimpor t " Re oiang 1 e * h *' 

^import "RectanglePtlnter.b" 


int main (int a rgc, const char ‘ argv {]) 
t 

Rectangle * rectangle; 

rectangle “ tlRectangle allocj inlLWithlieftX : 5 

bottomY ; '3 

rightX : IS 

topY : lOl; 

RectanglePrinter " printer • 

[[RectanglePrinter alloc] initj; 

[printer setRectangle: rectangle]; 

[printer printAreaJ; 

return 0; 

I 

M you C'an see, we’ve icnioved the aiitoreleusc^ [xx>l and all 
calls to release. Of course, there are still a few finer points you 
have to worry about, but in general, Apple has delivenxl on tliLs. 
Another imjor diffefenoe you will notice is that ifie dealloc 
methtxl is no longtir called, thus you should noi implement it. ITiis 
is kx'iiase you no lunger need to fc^aise your references to other 
objecis. Wliile the kick of dealloc is mainly traasptirent, theie are 
some cases when you wiU liave to restmaure your code a bit. For 
classes thai just release their instance variables, like our 
RectanglePrinter, it meaas we can just delete our dealloc 
meLluxl and things will work. We will gt) ewer the finci* [Xiints of 
GC as we a)mt^ acniss diem in fuaire artit*lc's, 

Ibe only major dowaside at diLs [loint is that GC is only 
supported on leopaal If ytm are writing cxxle thal needs to 
execoite on prior versioas of Mac OS X, yon W(jn’t k able to li.se 
G€, fust yet. 

('ondusion 

Oh}cx:tive-C memory tiianagemcni Ls a bit difterent from most 
other languages out there. I Intil recently, it used reference counting 
wliicii Ls more fiexifile titan malloc and free, but it's not 
completely autoiiuitic. Tliere aie a few rulc^ iliat you must follow 
in orckrr to pro[X*rly retain and rdc-ase olijeas. 'ITiis means you 
must coastantly think alxjut and follow die niles in your programs* 
Tlie advent of Leojxtrd brings us garfrage cxjllection and piomises 
to simplify memory miinagemeni even more* In eitlxT case, 
memory management Is a cornerstone of ObjeeXive^C 
prognimming. With this topic under your k4t, we cm start 
exploring areas of the Imindation and Cxxoa libraries. 

'/ill 
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Getting Started with Git 

Learn how to use Git to manage your project 


..S, by Jose R.C. Cruz 


Introducing Git 

Today, we will icx)k at Lite source-code management (SCM) 
Kx)! called Git. First, we will get a copy oi the Git soume tarfxill 
and (X)mpile Gil as a Univers;il Binary. Then, we will install the 
l(K)l and configure it on Mad)S X. 

Next, we will learn liow to use Git to do some t)asic SCM 
traasaclioas* Tlien, we will letirn how to use Gil in Xcode by the 
fXJwcT of menu scripts. 

The Git Project 

Git is an SCM system written ly Linus fbrvakls and 
nuiititained by Junio Hanuino. It serves as the official SCM for the 
Linux kernel pnjjcct. It is alscj a taster alternative to CVS Lind 
Suhveniion. 

Git is made av^iilal>ie under the leniis of the Gnu Public 
Ucease, veision 2. Also, when tliis article was written, the latest 
iLSiihle version of the Git projed is 1,5.2,3- 

Centralized versus decentralized 

Both CVS and Subversion store ilitxsc files in a cenrral 
fvfxKsitoryf (Figure 1). When usei?>, liere sliown as Jack and Jill, 
want to work on the profect, first they get u cafTy of the project 
from the repository. If user Jill changes some of the project files, 
she must commit tho.se dianges back to the repository. 
Otherwise, user Jack will lie unable to upcLite bis copy w'itfi her 
changes. 


□ □□□ 

— - I ant. 


UiptlAt* 




j copy ■ 


$ IQ 0 i 

“ i 0 . 0 J 




JiU 



Figure 1. A centralized SCM repository 


Git, liQwever, k?Ls users maintain their own local reptusiiories 
of the same pn>jea (Figure 2). K;ich user gels a copy of the 
project from their reptxsitories, and ujxiaies ti\e latter with their 
changes. If they want in see euch otlier changes, they tlien 
synchronize their repositories witli each other 
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Figure 2. A decentralized SCM repository 

Now, a centralized repository has its own set of 
prt^blems. First, this repository is susceptible lo data 
corruptitrn since it keeps all project files in one place. It use.s 
mtrre space since it stores all the clianges submitted by all 
tisers. It is also slower to respond since it has to sort out 
which changes belong to which user. Finally, it prevents users 
from working offline. 

These pn»blems, and others, aro non-existent if the 
a'fxxsitory is decentniltzed. 


Notable features and issues 

Git sliLires st>me of the feaitures found in Sulwersion. It troats 
files and directories as valid projea items. Il c:tm move or rename 
these items with a single command. It Lreals all commits to the 
repository as atomic operations. It also has native difl support to 
binary files. 

Git, ht)wever, can do S(M cransattions much fmlerthm CVS 
or Subversion. This Is partly due to ilte fan that it stores its 
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repository Icxrally wilJi respect to the user Gil also can doj^<3r/sc3^e 
collection U> trim cfeiid iterm from its repository. 'Ihb helps redtia.' 
the amount of space used by t!ie tepasirory. 

Still, Git has its own .set of Issues. For insUince, its primary 
interface is still tlie commanddine. It lacks a usable GUI tool 
tx>ninK>n to m<Kst host syslenis. It is more difhailt to backup and 
seaire, as there c^an Ix^ tiiure thm one reptxsitory for the same 
projea. Also, many developer t(x>ls such as Xaxle do not supptirt 
Git as a viable SCM system. 

Ihese issues, and many otliers, may be resolved by die time 
you read this article. 

Getting Git 

To compile and insiall your own Gil system, first get a cx)py 
of ilie project tarlxill git-1-5-2,3-tar.gz at the following 
V\<h. 

http://kernel .org/pub/software/sem/git/ 

Ifse the Finder to copy or move the tarl>all to the desired 
diiedory. 

Next, doubkH'lick the larixill to unp;it:k iLs contents. You nm 
also uiifyack the tarirall from a shellthe lenninal window by 

lypitig the following statentcnl:. 
tar git-1.5.2.3.tar.ga 

Make sure to use the cd command first !o navigiite to the 
dircxiory dial has the rarlxill. Fitlicr way, you should get have a 
directory named git-1 - 5 - 2.3 as a ivsult. 

Now, gel a a)py of the larlxill expat-2,0,1,tar,gz at 
the following URL:, 


http: //sou rceforge. net/projects/expat/ 

Kxpai h> an oi^en-source lihniry of funcTioas used m parse XML 
files. Move tlie tai+Kill to tfie same direciory as die Git tari^ftdl. 
UoubIcM'lick on the expat taiixill to unpack its contents. You 
should gel a directory namal expat-2.0.1 as a result. 

Compiling Git 

First, open the -bashprof ile file using your 
favouriiefavorite text editor Y<hi can find this invisible file in ytnir 
home direaory. Add the following entries to that file. 

PATH^- / Library / Dove loper/iiar/bin: /Lib rar y / Og velo pe c/uar/lib; $P AT 

export PAlit 

Sturt a 'lemiinal window session, and ly()e the following 
statements at tlie prompt. 

export CFLACS"’*-0 -g -ievroot 
/l>ovo]opor/SDKfi/HacOSXlO,4,u.sdk -arch "» 

1386 arch ppc** 

export LDFLAGS"’’-arch i}B6 arch ppc** 

'Ihe alxjve tells GCC to compile the expiii and Git binaries as 
Univ'ersid Binaries. Btii if you aiv already using MacOS X/Intel, set 

the CFLAGS varialilc with die following siatcnieni:. 
export CFLADS=”'0 -arch 1386 -arch ppc” 

Now use the cd command to navigate to the expat-2,0,1 
direaory. Q>nfigiire die projea by typing die following the 
statemenl. 

./cotlfigure -prefix=/Llbrary/l3evetoper/asr dt.^able- 
depEtideiicy checking 

31ie ulxwe tells the make ttKil to insiall die binaries into the 
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(liirnory /Library/Developer/usr. It iilsti telLs the tool lo 
igrioir all dependency chcvks. 

Coiii[^ilL‘ the expat I:>inarie,s l)y typing make at tlic 'lerminal 
prt>nipt. To test lite binaries^ type make check at the pitaiipt. IV) 
install the bimtries and siipptjrr hies, type make install, lo test 

the installed binaries, type the following statement at the prompt. 
/Llbiary/OevelopRr/uer/bin/xitilwf 'V 

You should get ilie string "xmlwf using expat_2.0* 1" 
displayed on tlie lenninal window. 

It is now ikne to compile the Git birutiies. Fiist, navig^iit^ tf> 
the diretlory git-1,5.2.3, At the Teniiinal pn)inptj tyjx^ make 
configure to generate the Cfvnfjgure script for yoursysiem. 

Next, configure the projcrl using the following suilement. 
./configure -prefix^/Library/Deveioper/usr -disabli? 
dependency- checking 

Ag-ain, this tells the tnake Ux)l to install the binarit!s into 
/Library/Develo|>er/usr, To compile tlie binaries, lypt^ 
make at the Terminal prompt. To iiLStall them, type make 
install. Finally, to test the installed biruuies, type* I he loll owing 
Staten lent at the prompt. 

/LItirary/Developer/usr/bio/giL -version 

You should get the siring “git version 1,5,2,3" displayed 
on tile Tcmiinal window'. 

NOTE: 

Tile alx)vc steps do not cotiiptle and iastall the help dtKninients 
for the Git system. For instructions t)n how to do so, visit Uie 

Wincent web fiage at tlie folltiwmg IM.. 
hHp://vri ncent.com/knowledgebGsa/ 

fnstolling_Gif_ 1 _5.2.3_on_MDc_OS_X_Jiger 

Configuring Git 

To configure Git for kx*il use, first you have to tdentify 
yourself to the system. Suppose your narncr happens to lx* 

User, and your e-mail addres.s 6k^u{M^r^rtM.kix.a)m. Iben, type 
the following statements at the Terminal prompt. 

git config -global nsjcr.naroe^-Pee User" 

git config -global user,emall"’"flce.user@aiail.box.ccHn“ 

Gil will use the alxwe informaijon to sign your committed 
changes. It will also use the same inft)miiitic3n for Us rejx)rt.s. 

Now supjxjise you want to use Git to track your foobar 
projc-cl. First, navigate to thc^ foobar diaxtory using the cd 
command. Tlicn type git init at Lite Terminal prompt. Git then 
CTGttes a ,git directory within tlie foobar directory. It uses tills 
invisible hidden directory lc> store and manage your projects 
repository. 

You ctiii also tell Git to [ilacc your project Fe|XJsil( 3 ry 
elscwlieie. For example, to .store the repository in the directoiy 
/Volumes/Projects/Database/git, add ilic following 
entry to your ,bash_profile file. 

export GIT DIR-'/Vnluraes/Projects/Database/git 

Restart your Terminal session, and type git init at tlie prompt. 
Gil will now cTeate the repository at the directory specified hy 
GIT_DIR. It will also make that nepasilory visil^le. 
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Working With Git 

liclow IS tlie Irasr u.'atgc synuix of the git a>nuniind-Iine tool. 

git options] IsyfacoTArnond [fiom/oand^optionsj ] 

llie global_optlons aigijment sets diose options ihai affect all 
SCM uuasaaions. flic subco/nma/id aigiinient selects what SCM 
ininHiiction to do. The command options aigument sets tliose 
options that aOect that transaction. 

Due to length, this article will cxwer only thi>se ojxions and 
sutK'omniands needed ft>r a basic SCM wtjrk cycle. To leant more 
alx)tit Gil, rc-ad die cxjmplete manual at the fttllowing URL. 

http;//ww.kernel -org/pub/software/scm/git/docs/user 
msnuul.html 

Handy global options 

To display the l<x)rs version, u.se the ^version option, 
git “Version 

To di.spiay a list of siilxrommands, use the help option. 

git ^lelp 

'lb change the re[x>sitoiy path, use ihe -git-dir option. 

git “git-dir"repoiJirory path ffulicoimnaju/ [coniraaiid options! 

'Hjen f)ass the new path lo ifie option as its parameier. This option 
also overrides the .selling made by the variable GIT_DIR. 

'lb Slone ihe rejxjsitory in the .same diavtury as iht^ project, 

iLsc^ die -bare option. 

git bare Kubcomraand Icotamand.oprions) 

lliLS is also the default opikm if you did not set the GIT_DIR 
variable, or use the gitdir option. 

Adding a project 

.Suppose you want tc] stoie your foobar paijed into the 
R‘p{>siu>ry. Fiisi, ase the cd command U) navigate lo the foobar 
prtjjed directory. 'Ilien lyiK" the following statement at the 
terminal pronipi. 

git add , 

Notice that the statement ends uilb a /k^rimL Tliis tells Git to 
include all the file and suixiirectories vviihiti the project dia^aory. 
Git also places an add tran.sacticm in tlie SGM queue. 

To complete the transaction, type the following statement at 
the pninifM- 

glt commit -m "Added the foobar project lo the 
repoeitory 

Git then cx>pies all die project hies am) sylxiireaorie.s into the 
repository. U also Ufxiates its log with the alxm- committal 
me.ssage. Teel free lo ti.se a different committal mt'ssage for your 
fxoject. 

Adding a profect item 

Suppose ytHi created a new file named foo.xml. To add 
this file to the Repository, use the add siilx'oniniand. 

git add f 00 ,xml 

Git places an add transatiion for foo-xml in its SCM queue. 
When you commit the transaction, Gtt then copies the file 
foo.xml into the repository. But if foo.xml is already in fhe 
repository, Gil will ignore the sulxommand. 


Now, supptxse you want tc^ add tfic sulxlirectoiy foo_bar to 
die mpository as well. Agjiin, just use the add sulxommand. 
git add toolbar- 

First, Git places an add transaction for fc>o_bar in ir.s queue. It 
then places add iraasactions for any file and subdireeU^ry found 
witliin foo_bar. Again, if foo_bar is already in the refxj^sitory, 
Git will ignore tlx* stilxommand. 

Removing a project item 

Suppose you liave ilie file flub.xml in the R^ptxsiiory. To 
lenxwe iJiat file, use the m .sulx:<jmniand. 

git rin flub.Kill] 

Git llien piace.s a remove transaction in Ils queue. When you 
a)mmii the transaction, Git deletes die file fnim die repository. It 
also deletes the same file in die project directory. 

Now, suppose you have the dircxtoiy flubar in tlie 
repositfiry as well To remove thai diretiory and any ilems ii 
amkiim, use the on subcommand with an -r option, 

git ria r flubar 

But if you know IxTorehanii that flubar is empty, |u.st use die 
rnt .sulxoniniand only. 

git riB flubiir 

Make sure, liowtrver, that the a^posiRiry has the items you want 
to remove. Otherwise, Git will respond with an error mc^ssiige. 

Moving or renaming a project item 

Supptxse you want to change tfie name of the file foo.xml 
to bar.xml. To rename the file, use the mv sulxximmand. 

git mv foe.xml bar.xml 

Gil placc-s a move Iraiisatiion in iLs SCM queue. Wlien you 
commit the traasiietion, Gil makes a copy of foo.xml and 
iissigas the copy with the name bar.xml. It then deletes the file 
foo.xml. Gil also mnames the foo-xml file in the pn^ject 
diR'cloiy. 

Now, suppow" you want to change the name of the directory 
foo_bar lo fubar. 'I'o reaame the diredory, use die mv 
SLibconirnand as follows. 

git tnv t'ou_bar fubar 

When you mmmit the transiitlion, Gi! first creatc’s die fubar 
diretiory in the rcpo.siiory. Next, it copies the aintents of 
foo_bar to fubar. It then tieletes the foo_bar directory fRxii 
die repository. Git ak) renames the foo_bar diretiory in die 
pnojetl directory. 

Next, suppose* you want to move bar •xml into the fubar 
directory. To do so, use the mv sulxornmand as follows. 

git ffiv bat.Xinl fubar 

Wlien you commit ihe iransaction, Git copies die bar •xml into 
fubar. It dien delete,s bar*xml in iis tiriginal location. Gil also 
performs the same openitiiins on bar*xml in the projed 
di rectory. 

Make sure that the iicni you want to move or rename exists 
in the repository. Also, if you are renaming a file or dirndtiry, 
make sure dial there is no item in the repasitory wiUi the new 
name. Odierwtse, Git will resjxind with an eiror message. 
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At,sc), if you moving a filt' into a directory, make sure that 
the directory exists in the repository. Otlicru'ise, Git will actually 
rename that file. 

CommitingCominitting transactions 

As sliown earlier, most SCM transactions go into a ijueue 
awaiting committal. To commit all the transactions in the ciueiic, 

use the commit siilxtanmand with an -a (jpiion. 

git coitmit a m ’'CoDaKiit all pending trails act ions'’ 

Git executes each iraasacliun m the order they apjxraa'd in ihe 
queue. H ilien atids ihe phra.st* T:ommil£tU{xmimgtmmactm 
to tile reposltoiy’s log. Again, led Ike- lo supply your own 
committal phrase. 

Hui supp<xse you made changes to the file bar,xml. To 
commit only those changes, u.se ihe .suixommand as follow.s. 

gtt cDironit ni '‘Hade changes to the file bar.xml" bar.xral 

First, Cut compares bar-xml with the one in iiie fe|Xisitory, It 
then stores oniy the diffemia^ hcmiKxm the Iwa into the 
repository. 

Now supp<ise you adtied two new files to tile lejxisiiory: 
char.xml and siu.txt. To commit only these additioas, use 
tlie sulx'ommand as i’ollows. 

git conumlt m "Added the files char.xml and sia.txt" 
char.xmi slu.txt 

Always [)mvide a concise dL'scnplum of what you are 
cr)mmitting. Failure to do st> will result in an maccurate log. If you 
foigoi to pnwide a description, Git wWl launch the default editor, 
which tlien [)rcHUpis you for the tk^scription. And if ytui .still fail 
to do so, GU unllahfjri ammUtalfmxjess. But it will not affect 
any transactions still in the queue. 

Disposing changes 

Supp<x5e you made dianges to the file char, xml. 11 ten y(>u 
find those* changes to he ineffmive. To revert to the last veision 
of that file, use tlte checkout sulxx)mmand. 

git thfickoul char,xml 

Git first ietrievt!s a cx)py of chax, xml from the repository'. It then 
replaces tlie char.xml file in the pft>jetl direaory with tiiat 
copy. 

Next, .suppose you added the file poink.htm to the 
reixwitory by accident. If you have nor committed tliat addition, 

you can cancel it l>y using die reset sufjcommantl. 
git rSBRt HEAD 

Tlie argument HEAD tells Git l.o reset the repository back to the 
state lietbre die queued addition. 

Now, suppose you have ccmimitted die addition. To cancel 

tliat coinmiital, use the revert sulxommiind. 
git revert ^o edit HEAD 

Tilts lime, the HEAD aigunient tells Git to reset the reixxsiitjry I jack 
to a state Ix^fom the aimmitred addition. Git dso updates the 
repfxsitory log witli tlie riglii description. 

Bexh reset and revert subconaiiands, however, may 
alTca odier ir;m.saciions as well. For insrance, if yrju liave an add 
and mv transaalons in die t|ueye, typing git reset HEAD will 
cancel h(jth traasactioas. If you have committed both transatlion.s, 
lyyiing git revert —no-edit HEAD will cancel fxUb 
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I'ommitials. careful when using tliese two sufxommantLs as 
you may lose more cbta tlian you expeci. 

Reports and logs 

SuppOwSe you just committed some of the transatlions in ilie 
SCM queue, ‘lb view what tran.saciions are stiU pending, use tlie 
status sulxTommand. 

git st&tus 

Listing i is a sample output of that suljcommand. Tlie first entries 
are rraasattions stiil in ibe Next are files that you haw 

changed. The last items are files and directories not in ihe 
repcxsitory. 

Listing 1- Sample output of git status 

# Oil brunch ntaatcr 
Changes to be committed: 

id (use "git reset HEAD (file).*." to unstage] 

if 

If new file; har,xal 

If deleted: foo.xml 

If 

If Changed but not updated: 

If tuse "git add ^file)'*, to update what will be 
comniitted) 

# 

# modified: fubat.log 

if modified: fuob.glf 

# 

jf Untracked files: 

# (use "git add (file)*.." to include in what will be 
committed) 

If 

ft fiibar_2y 

If bar. png 


Now, .supp<xsc you want a list of files and directories in your 
rejxxsitory. To get that list* use the Istree subcommaad with u 

-r option. 

git Is-tree -r HEAD 

listing 2 is a sample output of that sulxommand, Ibe first a)!umn 
is a the file's permission flag- the secxind Is the rtfXJsitory type. Tlie 
thirtl tolumn is the tile's hash ID; the third is the name and path 
of iliiit file. 

LLvting 2. Sample output of git is-tree 

100644 lilob Ib'i332bc'>re6e(jr4f>e37l36ebflealcd5be3a82 

foobar,cfis 

100644 blob dObc5d3b664497e4baddl2{l5dc7c:iSc025a320f 
foobar^htm 

100644 blob 09dblab264eb8El7089Sld8cde2efb33ee2Dele7fi 
fLibar/fflo-xnil 

100644 blob 2cc9eaa29leed362ee400dffd5lbZ5GA91riaf991 
fuhar/bar,gif 

Next* supp<jse you want to cximpare tlie project file 
foo^htm with the one in the repository. To do so, use the dif f 
.subconiinand. 

git dlff foo^htn 

If the file Is a text file. Git will list.s those Ihm of tett that have 
changed (Listing 3). If the file Ls a binary file, Gil will list die nmge 
of t^tes that have changed. 

Listing 5- Sample output of git dif f 

Index 76ea0fe..c932c':i2 100644 
— ■ a/foQ + htin 
+++ b/fcio.bun 
@@ -4,7 +4,7 ^ 

<html xinliis=''http://wvw.w3.orgy 1999/Khtml" xml:iang='"en’* 
lang-"en"> 

<bead) 
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<iseta http'equiv^''content-type" content^'text/hrinl: «. 

/> 

<title>F<K5bar A</title> 

+ <title>Foobar B</title) 

<iBeta naBie='"generatoE" content="BBEdit 6*5.3" /) 

<Iink re1-="Stylesheet" rev="Stylesheet" 
href="foobai! .cse* /) 

</head) 


Supixxse you want a prolvci Iiisiory. To ifiai hLstory, us<^ 
the log sulx’ommand. 

ftit log 

Listing 4 si tows a sample out pul of tliat sutx:ojnmancl. Hitch entry 
consLsts of at least four lines. The first line Ls the imrmtction //>. 
llie seeontl h; the t 4 ser who made the tratmctkm. T!ie third line 
is the date and time of th(f immactioti 4lie remaining lines 
deserilx? the transaction. 


Listing 4* Sample output of git log 

coiwait ^a.q079bciid2tTU5tc4eeflJ«4aJ34af395462bfn 
Author: Dee User <dee.user#mail*bf>x*coin> 

Date: Thu Mg 23 13:26:55 2007 -0700 

He vert ^Changed the file foobar*htin" 

This reverts conrait 

n33d0ald3af8fe9/if7^idDrc2<^5b65ei8S20noK 


commit 1133d0ald3af«fr94f74d0cc2c5b6581882012el 
Author: tlee User <<iee*userimail.box.com) 

Date: Thu Aug 23 n:]4:18 2007 0700 

Changed the file foobar*hinj 


Gir uses the less totjl lo display tlie pmject ]ii.stnr>, To page 
down the liistory, prt^s the Spjice-har. 'lb page up, press the <B> 
key. 

Now, snppcxse you want a list of users who worked on the 
file foo.htm. 1b display tliose users, use the blame 
sulxununand. 

git blame foo.litb 

If the file is a text tile, Git dLspbys the lines of text and tlie iwU 
t 4 ser wh€} edited mch line (Listing 5). If the file is a binary file, Git 
displays each line of hexadedinal l)ytes and the UlsI tmfr ufho 
changed thiftn. 

Listing 5* Sample output of git blame 

7442b04 (Dee User 2007 08 04 13:11:5/ 0700 1} <?xnii 

veraioa=‘'1.0* » 

''74«bO'i (Foo Bar 2007 00 04 13:11 tS7 -0700 2) <ID0CTlfPE html 

PUBUC 


*74421>04 (Bar Foo 2007 08 04 13:11:4/ -0700 3) (html xiilna-"_ 

*7442004 (De« User 2007-08-04 13:11:57 -0700 4) <head> 


The following are llitec‘ exampies of Xctxle menu scripts that 
use Git* Heel free to modify these scripts tt) suit your [}rojea 
neetLs. 

Storing the project 

[.Lsting 6 shows a menu script tkit stoms the current projm 
into a Gil repositt>ry. 

Hirst, the script add tfic directory 
/Library/Developer/usr/bin to the PATH variable* Tlien it 
prompts the user for a desc ription Eli the prtjjeci* After llie user 
supplies a valid description, die aript cTeaies an empty Git 
repcjsiiory. it then acids all the files and directories in the current 
project to that repexsitory* 

Listing 6. Adding a project to Git 

tfl /Itin/baeh 

# 

tf - PB User Script Info - 

If tt%|pBXMaiiie=Add project to the repository I %%% 
if U%iPEXXnpirt=None)%%% 

If %%%lF0XOutput-Dificard|%%X 
if XX%lP8XKeyEquivalent-im 
If %XXiPBXArgiiiieot=|%lX 
# 

# set the following shell varlablefl 

export PATH^'/Library/Dove1oper/usr/bin:$FATir 
GlT_MSC='date "ieoDmiitted on WXd/Xy XH:%M:XS"^ 

# prompt the user for a commitalcoilimittal message 

GIT _ KSG-^ r 1 pt « APPt.ESCRl PT 

tell application "Xcode” 

activate 

display dialog "Reason for cammlttsl" default aru^wer 
**SiGlT_mGr 

return (text returned of result) as string 
enfj tell 
APPLESCRIPT 

If validate the message 
GlT_aiX='expr ‘$G1T_HSC'' : 

if [ §GlT_aiK -gt 0 j: 
then 

if initialize the repository 
git inlt 

If add the project files to Ltie roposiloiy 
git add . 

If commit the project files 
git commit ro "$|GIT„HSGr 

echo "Finished adding the project tq the repository," 

else 

echo "Yon must supply a coMnittai message." 
fi 

Making a transaction 


Xcode and Git 

Currently, you eaa only itsc O/S t>r Subvention to mamtge 
your Xaxle projects* But, witli a Utile work, you can also use Gil 
for tlic jiitme Disks. All it takes Ls to write menu scripls tJi;it will 
add Git functionaUly to your Xc(xie setup. 


Listing 7 sht>ws a menu script that will do four bLisic SC]M 
IrarLsactions* 

Hirst, the scriiX creates a .sepiirale menu optkin lor each 
trans:ictic3n. It also adds the direciory 
/Library/Developer/usr/bin to the PATH variable, Next, 
the scriiit checks which transiiction ihe tistT has chosen* If the 
iniasaction needs more data, the script [7rom[)Ls the user for I hat 
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datiL Finally, the sciipt exeeures rhe right ,siilx:<)ntinunti for tJie 
chosen t ra nsat'l k )n. 

Listing 7. Making four basic SCM 
transactions 

/bin/bsf^h 

# 

# - PB Uaer Script Info - 

^ %%% E PBXNane=^giiiMt cbfknge^; )%1X 

# %%X(PBXArpiDent= feavlXXX 
(f %%SIPBXOutpat“Disc;ardl%%% 

# miPBXK«?yEquivalent=3XX% 

If 

# %X%fPBXNowScriptl%%% 

(f X%%lPBXNaiDe-Add the 

# %X%tPBXAcgumRhi = -faddjm 

# %X%(PBXOytput-0iscardi%X% 

f 

if XXXtPBXNevScrlptlXXX 

# Xl% \ PBXNume“t) i sf a rd cbanges IXXX 
j! XXXI PEXArgumen - f re v) XXX 

# %XXEPBXOutput=DlscardlXXX 

# 

# XXXEFBXKevScriptlXlX 

# XXXlPBXNatOG-Tag the project IXXX 
f XXXlPBXArgument” plagtXXX 

# XXXlPBXOytput-OlscardJXXX 

tf 

# eel the following environtnent variable 
export PATH^"/Librnry/Developer/usr/bin:$PATtr 

# set the follovltig shell variables 
ClT_PTil"^XX [ PBXFi 1 oPa th IXXX 

GIT PTH-'basename $GIT„PTH' 


# determine the selected git transaction 
if t -gt 0 J : then 

If [ "K$nj'' = "z-fsav" 1 ; then 
# coiBinit the cut rent file 
GIT_ASK=i 

GIT_HSG^"Enter a coramlttal message"* 
GlT_,DAT’'date “+Coiimitted on Xa/Xd/Xy XH:XK:XS"*' 
ellf f “ “£-ptag" [ t then 

If apply 3 tag to the project 
GIT_HSG“''Set the project's revision tag to” 
ClT„DAT="aate ”+XiiiXdXy_XHXMXS'" 

GIT.ASK-l 

else 

GTT ASK=0 

fi 

el He 

// just exit 
exit 0 
fi 

tf prompt the user for input 
if t SgIT_ASK eq 1 1: 
then 

G1T_DAT^' cisnscript « APPLESGRIPT 
tell application '"Xcode” 
activate 

display dialog “$|GIT_HSGI” default answer 
“${GlT_DATr 

return (text returned of result} as string 
end tell 
APPLESCRIPT 

# validate the user input 
GIT_CHK-'expr *‘$C1T_DAT’* ; 

if t $GIT_CHK le 0 j; 
then 
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Express $99.99 
Extreme $179,99 
BlueToothUpgrade 
$39,99/59,99/79,99 


Parts, Parts, Parts 


We have an extensive 
supply of cosmetic 
parts for iMacs, G4/G5 
Towers, eMacs etc* 

LCD Panels for G4 iMacs 
G5 iMacs, Power Books 
and Displays, 


Parts for Every Mac System 


Logic Boards 


WWW, mac- resource.com 


G 3/G 4 P CI / A G P : $12 9 


G4 
G4 
G4 
G4 
G4 
G 5 
G4 
G 5 


Gigabit/D Audio: $199 
Quicksilver: $3 4 9 
MOD: $489 

eMac Logics From $189 
iMac logics From $199 
Towers S399/$499/$599 
Xserves $149-$299 
xserves $599 



Mac Systems 




Power Supplies 


G4 
G5 
G 5 
G4 
G4 
G4 


iMac 15/17/20: S79/S99/$1t9 
iMac 17/20: $149/$179 
Tower: S 1 69 / S 1 99 
Qsilver/D audio:$179 
Gig E-n e t / M D D: $ 19 9 
AGP208/237W: $179/$219 


466Mhi $194 

G4 733/SOOMhx $449/3549 
G5 1.6/1.SGhi $799/3599 
G5 1.8/2.0GI11 DPS1 199/31 299 
G5 2.5/2.7Ghi OP 3l499/$l599 
GS 2.5Ghz aUAD DUAL DVI $1799 
NEED G5 IMACS? 

GS 1.6/1.5/1.9Ghi 17« $699/3799/$599 
GS 1. a/2.0/2. IGHZ 20** $5 99/$ 9 9 9/$ 1 09 9 
EMACS GALORE, GREAT WORK STATIONS 
700MHZ 2S6/40GIG/COMBO/1 7*’ $319 
1.DGHZ 2S6/4aG|G/COMDO/1 7" $349 
l.2$GNZ2S6/40GIG/COM 00/17" $399 
t.AZQHZ 2S6/aOGIG/SO/1 7" $499 


New Systems 
Arriving Daily i 
Cali for Latest 
Stock. 


WE HAVE eS XSERVES AMD RAIDS 


EVEN IF APPLE DOESN'TIIII 


Lvilc bairtf and pwaf stppllts rk^n-lra 


QBmm 


Processors For G4s, G5 & Xserve: 
G4 466/7JJ/800 S49/$149/5199 
G5 1.6/1,8GHZ $399/$499 
DUAL PROCESSORS (S PER PROC.) 

1.8/2.0/2.JGHZ 399/549/599 
2.5DP/QP 5699/5799 
XSERVE PROCESSORS 
G4 1.33GHZ DP $189 
G5 2.0/2.3GHZ $229/699 


'G5 XSERVE CLUSTERNOOES 51429 
GS XSERVES FULL UNITS S1849nfl 
1 TB XSERVE RAIDS FROM 542991111 
2.8 TB XSERVE RAIDS FROM 549991111 
5.6 TB XSERVE RAIDS FROM $62991111 
3.5 TB/7.0 TB XSERVE RAIDS S5899/S7999 
RAID CARDS, FIBRE CARDS, DRIVE MODULES 
POWER SUPPLIES, CONTROLLER MODULES ETC 
OVERNIGHT SERVICE AVAI L ABLEl 111 


Displays 


Thousands of parts 
_ for all Mac sys tems 1 

1 - 888-Mac-Resource 


REFURBISHED DISPLAYS 
17” Studio LCD: $299 
22”/23" Cinema: 5499/S599 
15” Studio LCD: 599 
17” Studio CRT,ADC/VGA: 549.99 

Products refurbished or demo, 
catl for more information 
























# just exit 
exit 0 
fi 
fi 

I execute the git ttfinsactiotv 
if 1 *'zS(lP ^ "7. fsav" ] : then 

# gii commit 

git comiiit m -${GlT_nATr $G[T_n'U 
elH t "iiSlir = "z-fadd** 1 ; then 

if git add 

git add SG1T_PTH 

ellf I •x$ilP ” "X frnv" ) : then 

# git revert 

git cheekoul SGIT^PTII 
ellf [ "z$n]'’ * "Z'ptflg" 1 ; then 
if git tag 

git tag “$(GIT DAir $GIT.DAT 

else 

^ just exit 
exit 0 
fi 

Displaying a report 

Listing 8 shows a menu script dial will display four ty|xs of 

rcfXjrLs. 

First, Uk‘ sLTipi rrc-dius a at?w nu*nti option for each fetx>rt. 
'llien, it adds /Library/Developer/usr/bin to the PATH 
variable. Next, it checks which re|K>rt the user waiiLs to display, 1i 
tJien uses ilie rijthi siilx-ommand to generate the rejxjrr. 


Finally, the sc^ript stores the ref>ort output into a teinj)t>rary 
file. Then it uses Xctxle to di.splay the contents of that file in a 
separate window. 

Listing 8. Displaying an SCM report, 

9 

9 PB User Script Itifa - 

# %%%(PBXNam^-Show file hisiory)%%% 

9 %%%lPBXlnput-Nonel%%% 

If %%% \ PBXArgiimenf' f his I %%% 

# %\XlPflXQiitput=Sep3rateWindowl%%% 

S 

9 %%X]PBXNewScriptl%%X 
// %%%|PBXN^}ino=Shi>w file di f ferences 
9 %%%|PBXArguTnent=-fdif 
9 %%%[PHXOuLput=SeparateWindow)%%S 

# 

9 %X%EPfiXKcwScript(%%t 
9 %%lt f PEXName=Show project ti i ntory JiTtM 
9 Xitt (PKXAr gumeri t= - phis I %%% 

9 X%%t PBXOiitput=SeparatGyindowl%'%% 

9 

9 XXXlPBXHewScriptJXn 

XXXl PBXNaine^Show project status |%X% 

# XXl IP BXAr gument^ - p r pt J %XX 

# XXXl PBXOutput^SeparateWindov] 

If 

9 set the following environment variable 
export PATH'’*' /Li h ra ry / Developer /usr / bin; $ PATH"" 

9 set the following shell variables 
G1T_FTH=X%%IPBXFilePath1 %%% 

GIT PTH''basenatnc $GIT„PTir 




The USPS Postal hike has catalogers and vendors justifiably 
very concerned. Now that holiday direct marketing strategies are 
been planned, this postal hike repiesents a significant additional 
investment, without supplemental return. 

Over the last five years, many companies have shifted a portion 
of their marketing from print to online and email. With this postal 
hike in place, increasing your online presence is even more 
critical to the health of your business. 

Waller Karl Interactive can help your bigness by using email 
append and replacing your postal mailing with an ^ail campaign. 

This approach will substantially cut postage expenditure and 
increase your margins. For those custonws that fall of! your 
mailing plan because of the tinrie since their last purchase (and 


the resulting lower response rates), there is ariolher option. 

Walter Karl Interactive can help you reduce your postal 
expenses by providing you with a permission-based email 
address for your customers. You can reduce the frequer^cy of 
your pastal direct rr^l campagns to these online customers 
WITHOUT reducing the frequency of communicalions to them. 

Please contact Dan M, Babb at 954-660-0225 
or E-mail; dan,babb@wkinteractive.coin 
Website: wwwJ^pentt5enrjces.coin 

4 Gannett Drive, Suite 350 
White Plains, NY 10^4 
Tel: 954^0-0225 * Fax: 954^365-6610 
Visit us at: www.appendservices.com • www.wkinteractive.oom 


IMalterKarl 

mgactiv® 
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Measure 2.0-4.0 GHz & 4.9-5.9 GHz bands 
Demodulate All 802.1 Ib/a/n/g packets 
User Selectable Power Triggers 
W.I.S.P. Antenna Alignment 
Multipath, MAC, SSID & Absolute Channel 
MAC Security Authorization Lists 
Interference Mapping Softwore (optional) 
RF Direction Finding (optional antenna) 


NOW SUPPORTS 802 .tin 


Yollawfockot B/A/G Is perfect for 

miosurlog any cfeyfca in ycur 602.7Tn 
HoNpof or WJ.S. P. rrshA/'orlc rncfLxcfmg App/n's Airport Extreme Bos^ Sfah'orr. 



Berkeley 

Varitronics 

Systems 

732 - 548-3737 


Serving fhe 
wireless industry 
for 35 years. 


www.bvsystems.com 


GIT„I>IH-'osascript <<’APPLESCRrPT 
tell application 

path to tenporary items from uset domain 
FOSIX path of result as string 
return result 
end tell 
APPLESCRIPT 

If set the chosen git subcommand 
if I S# 'gt 0 1 ; then 

If [ " 2 $ni" ” 1 : then 

i display file history 
ClT_DOC-*‘SGrOTR/git_f hist. OUt“ 
elif [ - “Jt-fdif- ] ; then 

# display file differences 
GIT.DOC-'" BGIT_DIR/ git_f di If, out" 

ellf [ " ^a phia*' ] ; then 

It display project history 
GITJIDC”* $ GI T_D T R / gl t_ phi st. o uf 
el if f * "z-prpt” J ; then 

# display project status 
GIT_DOC-’^$GIOIR/git_pstat .out " 

else 

exit 0 
fi 

fi 

GTT_DOC“$IGTT_DOC //\/\//\/i 

# execute the git transaction 
if [ “aSJlJ" * “i-fbis" ] ; then 
I display file history 
git log SGIT_PTH > $GlT_nOC 
elif [ “zSIll" * ""x fdif 1 : then 

# display file differences 
git diff $GIT,PTll > $GIT_D0C 

elif r "zSllI" “ “z phis“ J ; then 
if display project history 
gil log HEAD > $GTT_DOC 
elif I "zSni” = "z prpt** ] : then 

# display project statue 
git status > $CIT_1X)C 

else 

exit 0 
fi 

Ifdlsplay the gll: report document 
GTT^DGC^^OS X' echo SGIT^OC' 

C1T_I>0C-^ echo $ ^ GTT_D0C/ / W / H ’ 

G TT ^ DOC-“\“ $G It_D0C V"" 

osascript « APPLESCRIPT 

tell application “Finder'* 

set fileref to get file SG1T_D0C as string 

tell application 'XCode*' 
activate 

open file fileref 
end tell 
end tell 
APPLBSCRIFT 

In Summary 

Cit Ls another in the line of tools for managing software 
j>rojects. Like CVS and Subversion, Git is an ofien-source pioject. 
Users can downloatJ its sources and port tlie tool to their own 
operating syslenis. But unlike CVS and Subversion, Git lets users 
work on the same project m a distributed, non-ceniralized 
fashion. 
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CodeMeter: Ready for Leopard 


Picture: PiXi 


Highest Security 

• Vetidor selectable secret and private key. 

■ Strong encryption algorithms with AES 128-bit and ECC 224-bit. 

■ Best-in-class tools for automatic protertion (envelope, without source modification) 
for Win32, Win64, .NET, Java and MacOS X Universal (PPC, Intel). 

Best Flexibility 

■ More than 1000 independent licenses can be protected by one CM-Stick. 

« One versatile hardware key for all license models including floating network licenses. 

■ Multi platform support including Windows, MacOS X and Linux. 

New Distribution Channels 

■ License transfer by SOAP based CM-Talk or file based Field Activation Service in e-shops, 

■ Multiple-purpose, including protecting low cost software and digital content. 

Unique End User Advantages A 

■ First and smallest dongle with up to 2 Gbyte flash drive. v 

■ No drivers necessary - can be used without administrator rights. . 

■ CM Password Manager, secure virtual drive and secure login. A 


Order your Free Software Development Kit nowl 
Phone 1-800‘6‘GO‘WIBU [ order@wibu.us 



WIBU-SYSTEMS submitted the 
CodeMeter Password Manager and 
the CodeMeter SDK for the 
Apple Design Awards 2007. 


UIBU 

SYSTEMS 


WtBU-SYSTEMS USA Inc 
2429 NW197tJi Street 
Shoreline, WA 93177, USA 
www.wibu.com 
info@MVibu.us 
Tel: 1.800.6,CO.WIBU 
1.206.S46.4891 
Fax: 1.206.237.2644 


©2007 by WIBU-SYSTEMS USA. Inc. All rights reserved. 
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http://g it.or.cz/course/svn.html. 

Wikifxxlki. Git (sojtimtv) (2007 July 13)- Cx)f)ynglit 2007. 
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SPEED DOWNLOAD 


THE FASTEST MAC OS X DOWNLOAD MANAGER 

PLUS A 1/I/H0/.E LOT MORE/ 


LEOPARD 
. READY! 




AUTO RESUMING DOWNLOADS 
BUILT-IN FTP CLIENT 
ENCRYPTED P2P FILE SHARING 
COMPLETE BROWSER INTEGRATION 
FULL IDISK CONNECTIVITY 
AND MUCH MORE! 


mE21 bAYfffl- GET IT TODAY 1 
WWW.YAZSOFT.COM 
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Mac OS X 10,5 Leopard: 
Visual QuickStart Guide 
rSBN: 0321496000 
Maria Langer 
Available now! 
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Mac OS X 10.x 

Leopard 
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Mac OS X 
Support Essentials 

socond amion 

A QukId Ifl SuoparUnq mvi IlmiMaiin ihiW^i Mac PS X 

■fl 


Apple Training Series: 

Mac OS X Support Essentials, 
Second Edition 
ISSN: 0321489810 
December 2007 


Mac OS X 10,5 Leopard: 
Peachpit Learning Series 
ISBN: 0321502639 
Robin Williams 
Available now! 
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AUTOMATOR 

FOR MAC OS X ms LEOPARD 


Qukif and iasy Wayf 


DENWALDEE 


Mac OS X 
Server Essentials 

Second EitttiQn 

A auid«i In uwme nmi suppctting Mftc QS X Sm-viaf 



Apple Training Series: 

Mac OS X Server Essentials, 
Second Edition 
ISBN: 0321496604 
December 2007 


Are you 
ready for 
Leopard? 

Learn the ins and outs of all the new 
features in Mac OS X 10.5 Leopard, 
including Time Machine. Spaces, Quick 
Look, Automator, and more. Whether 
you're an experienced Macintosh user 
ready to hone your trouble-shooting 
skills, or you're leading a group of 
beginners who need help getting 
started, pick up a Peachpit book today to 
get the most out of the powerful 
features in Leopard. 


BUY NOW AND SAVE! 


Purchase or preorder your copy today 
and save 35% off the list price, plus free 
domestic shipping. Simply go to 
vvww.peachptt.coin/leopard and enter 
coupon code PP-LEOPARD when you 
reach the checkout page. 


Automator for Mac OS X 10.5 
Leopard: Visual QuickStart Guide 
ISBN: 0321539354 
Ben Waldie 
December 2007 
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Now scheduling 
and contact 
management 

for your entire 
organization. 



Now I Up to Date* and Contact* 


Calendar and Contact Software for Business, Groups, Families and You, 




Is this project on schedule? When are you available to meet about the systems 
upgrade? Where are all the field techs today? When was the last time anyone talked 
to our biggest customer? 

Virtually all groups live [or dte) by their abilities to meet deadlines and keep trock of 
their customers, prospects, ond vendors. Fev^ smoll componies or even deportments 
of big componies have the tools they need. 

Now Upto-Date Contoct might just be the calendar and contact software for you. 
It's time-tested and used by more Mac-based companies than any other solution. And 
ifs cross-plotform-availoble for your PC users, too. It's easy to install and monoge ond 
simple for your employees to understand ond use. 

Using Now Up-to-Date & Contact you can schedule meetings for multiple users, view 
multiple, simultaneous calendars, ond reserve rooms and resources. You can share 
contact information about your customers, prospects and vendors. And using our free 
server software you can set it up in minutes and share with users in the office or from 
anywhere with on internet connection. 


New 

SOFTWARE 


Call us now at 866-527^556 or emoil us at madech<i'nowsoftwar 0 ,com 
and weil send you our Free eyaluation kit, inctudirtg the book that will 
make it all easy, 'Take Control of Now Up-to*Date 8 ^ Contact'' from 

Phone: 866-527-0556 1 

Take Control bdoks! 


Web: www.nowsoftware.com 


Copyright o 2lt>0s hf Npw SottworB, Inc. Ail lighb iwBrvod NiM Up-lO-DotB tmd Nqw Conlocit or* ragntBiEd ttodfitfliorki of Now SoltwoiB, Inc. Moc ofkci th« Mac logo or* lirod«itiorl(i ol CDOipulBf, linc.« 
mgiilwed m th« U,S. and odiBr ctnr^rfti Alf oltwr trodomQiHb odcnowkdgtd. 
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THE MACTECH SPOTLIGHT 

Marcus S. 
Zarra 

Owner, Zarra Studios, LLC 

htfp:/ / www.zarrashjdios.com 


What do you do? 

j am iJic j)rimary developer for 
Studios develops two software lilies in hi 
Elegant Salehs) a Point of Sale system for OJ? 
a post prfH:esst>r for Apple's iWeb 2008, 

I am also working with Jon Trainer of 
develop bull Frog 2 one of the first Leopard-<inly video gttmes. 

Lastly, Zarra Studios develops software For oiher 
eompanics such as I'winspart:, AcrcK'at, and several mhers. 

How long have you been doing what you do? 

I have lx:en doing consulting work since 1996 and formed 
Zarra Studios in 2005 to proeex^d the launch of seSalcs- Prior 
to 1996 I was develotring softward for law Finns in Phoenix, 
Afiy.ona, 

Your fim computer: 

The first computer I ever worked with was a Radio Shack 
ritS-80 Mcjdel L 1 learned BASIC on ihe TRS-80 and then 
learned Assembly on an Apple De. 

Are you Mac-only, or a multi-pktform person? 

As of 2002 1 have been using Macs exclusively. Prior to 
that I havetiised just alxjut every operating system available. 

What attracts you to working on the Mac? 

11ie elegance of the platfonii and the attention to detail are 
what initially brought me back to Apple. However it was the 
design of Cocoa and Objeci.ive-C that made me want lo 
develop for llie platform. Prior to that I had been using OS X 
to develop Java applications, 

Tfiere .simply is no other language i would ralher be 
working in nor any other platform I would rather be writing for. 
Apple has really nailed it, frimi the developer's point of view, 
when ir comes ease of development and design. 

WhaPs the coolest thing about the Mac> 

From a business point of view, I would have to s;iy the 
shareware market. I once heard it referred to as the Wild West 
during the Gold Rush. I would have to say that is a fairly 
accurate description. On no other platform can an 
independent software vendor have such an incredible 
opportunity to make a difference. 



If 1 could change one thing about Apple/OS X, I'd: 

I have very few complaints with OS X. Probably my 
biggest complaint is the fact that the ctmsumer level 
applitTiiions provided by Apple do not send out very many 
distributed notifications nor are they very .scriptable. For 
example, iWeb does nt>i allow you to watch when it has 
finished publishing a site. Another examj’>le would lie that 
iTtmes does not allow you to set or l(K>k at the settings of Air 
Tunes speakers. It would really Uvip developers if we had 
greater access to these consumer afiiilications to extend diem. 

WhaFs the coolest tech thing you've done using OS X? 

The coolest thing I have dt>ne for OS X is unfortunately 
under NDA. I can say that it involves Bonjour, Distributed 
Objects and iTiines. BeyotKl that I unfortunately cannot 
release until the application has iK^en completed. 

Ever? 

In the late I990's 1 wrote a crossword puxj^le applei in java 
for Timodiy Parker and Universal Pi^e-ss Syndicate. That applet, 
unlieknownst in tiie at the time, changed the way that 
crossword puzzles would be played on the internet forever. 
Up until it was retired a few years ago, it was the most played 
applet and crosswt>rd puzzle appliauion in the world. 

Where can we see a sample of your work? 

Most of my ciirrent work can be dtjwnkjaded from my 
website at hHp://www.zaiTastudios.com. In addition, there are 
links on my website to work I have dt>ne for other companie.s. 

http://www zarra studiosxom/ZDS/seSales.html 

http: // WWW. zarra studios .com/ ZDS/ i WebBuddy. hfml 

The next way Fm going to impaa IT/OS X/the Mac 
universe is: 

With iWeb Buddy, Once it is rele;ised it is gomg to allow 
more people to utilize iWeb to write tiieir blogs and run their 
websites in ways that are not currently jxjssible. 
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At Small Dog, we’re obsessed with the new stuff too. We have been a part of the Mac oommunity 
for over a decade, and we still get excited about It! 


^ " .ripsw, piDduGts, new 

and support Apple's newest innovetbns along with relirbished Macs, iPods and over 3,000 
other Mac-friendly product^; Arid We have a new website to mate it easier to buy thani ever. 

.,ii Check out Smalldog.com to see what we have in store for ycu! 


INDULGE! Save$15off 
of your next purchase 
of $ 1 00 or more. 
Enter the coupon code 
mactechnew” at checko.ut. 


fk Apple Specialist 
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Work together. Differertl rriachines? Different platfornns? No matter You can all speak the same language 


loos 


,com 


Office: mac 













